Orca is the place for working with a fleet of agents (e.g. Grok Bot, Claude Code). Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.
TypeScript adeagent-ideai-agentsautomationbotclaude-codecodexghosttygrok-bothermes-agentmobile-appmuseopenclawopencodeorchestrationpiruntimeterminalworktreesyc-backed
import { TerminalKittyKeyboardModeTracker } from '../../../../src/shared/terminal-kitty-keyboard-mode-tracker'
import type { TerminalLaidOutCellBox } from '../terminal-cell-box'
import { DEFAULT_TERMINAL_THEME } from '../terminal-webview-html/theme'
import {
createEngineTerminal,
createEngineUnicode11Addon,
createEngineWebglAddon,
installWindowErrorReporter,
installWindowHostTransport,
paintWindowDocumentBackground,
postToReactNativeWebView,
windowCapturedEngineErrors,
windowHasEngine,
windowStart,
observeWindowViewport,
windowViewportRect,
type TerminalDocumentHost,
type TerminalDocumentHostSeams
} from './document-host-seams'
import type {
TerminalDocumentDisposable,
TerminalDocumentTerminal,
TerminalDocumentTheme,
TerminalDocumentWebglAddon,
TerminalInitialOscLink
} from './document-terminal-shape'
import type { TerminalMouseGesture } from './mouse-click-drag'
import type { TerminalTouchState } from './surface-touch-gestures'
import type { TerminalTouchDispatch } from './tap-dispatch'
import type { TerminalDocumentThemeMessage } from './terminal-theme'
export type * from './document-terminal-shape'
export type { TerminalDocumentHost, TerminalDocumentHostSeams } from './document-host-seams'
// Keep cross-module mutable state per document; module-private state stays local to its factory-emitted module.
export type TerminalDocumentState = {
term: TerminalDocumentTerminal | null
// Pan is measured in viewport pixels.
panX: number
panY: number
terminalGeneration: number
termObserverDisposables: TerminalDocumentDisposable[]
initRows: number
webglAddon: TerminalDocumentWebglAddon | null
webglRecoveryTimer: ReturnType<typeof setTimeout> | null
terminalThemeInput: TerminalDocumentThemeMessage
// Carry sub-line wheel travel between events; touch scroll resets it.
wheelAccumDeltaY: number
defaultTheme: TerminalDocumentTheme
terminalTheme: TerminalDocumentTheme
terminalMinimumContrastRatio: number
initialOscLinks: TerminalInitialOscLink[]
initialOscLinkRowOffset: number
lastEmittedModes: TerminalDocumentModes
everReady: boolean
// Encoding is proven by 1006/1016, RIS or live tracking enable, never guessed from replay.
mouseEncodingKnown: boolean
// Retain a chunk tail because DECSET can span writes.
mouseModeScanTail: string
trackedMouseTrackingMode: string
sgrMouseMode: boolean
sgrMousePixelsMode: boolean
keyboardModes: TerminalKittyKeyboardModeTracker
scrollIndicatorHideTimer: ReturnType<typeof setTimeout> | null
handledMessageIds: number[]
currentTextScale: number
terminalFontFamily: string
firstDataPending: boolean
reportedCellBox: TerminalLaidOutCellBox | null
activeAltScreenSnapshot: boolean
currentScale: number
userScale: number
// Remember incomplete selectors across queued chunks.
statusDotPendingSelector: boolean
writeQueue: TerminalWriteQueueEntry[]
writeQueueHead: number
writesDraining: boolean
afterDrainCallbacks: (() => void)[]
ready: boolean
smoothScrollOffsetY: number
pendingNormalScrollDeltaY: number
normalScrollFrameId: number | null
selMenu: HTMLElement | null
btnCopy: HTMLElement | null
btnSelAll: HTMLElement | null
edgeScrollTimer: ReturnType<typeof setInterval> | null
edgeScrollDir: number
edgeScrollClientX: number
edgeScrollClientY: number
initialOscLinkEvictionReady: boolean
selectionOverlay: HTMLElement | null
handleStart: HTMLElement | null
handleEnd: HTMLElement | null
selMode: string
sel: TerminalDocumentSelection | null
longPressTimer: ReturnType<typeof setTimeout> | null
longPressOrigin: TerminalDocumentTouchOrigin | null
interactionActive: boolean
tapCandidate: TerminalDocumentTapCandidate | null
bottomRowBackdrop: string
surface: HTMLElement | null
pendingTerm: TerminalDocumentTerminal | null
// The anchor the pending replay will restore; null after a clear or an alternate-screen snapshot.
pendingReplayScrollAnchorRows: number | null
committedTerm: TerminalDocumentTerminal | null
provisionalTerm: TerminalDocumentTerminal | null
committedSurface: HTMLElement | null
pendingSurface: HTMLElement | null
scrollIndicator: HTMLElement | null
scrollThumb: HTMLElement | null
terminalDataRepliesEnabled: boolean
linesEverWritten: number
nonFatalErrorNotifies: number
uninstallErrorReporter: (() => void) | null
uninstallHostTransport: (() => void) | null
cancelFontReadiness: (() => void) | null
removeViewportRefit: (() => void) | null
removeTapDispatch: (() => void) | null
removeWebglRecovery: (() => void) | null
fitRetryToken: number
hostFrame: { width: number; height: number } | null
fitPending: string | null
mouseGesture: TerminalMouseGesture | null
touchDispatch: TerminalTouchDispatch
touchGesture: TerminalTouchState
scheduledFrames: number[]
framesStopped: boolean
}
export type TerminalDocumentScope = TerminalDocumentState & TerminalDocumentHostSeams
export type TerminalDocumentSelection = {
anchor: { row: number; col: number }
focus: { row: number; col: number }
activeHandle: string | null
}
export type TerminalDocumentTouchOrigin = { x: number; y: number; identifier: number }
export type TerminalDocumentTapCandidate = TerminalDocumentTouchOrigin & { t: number }
export type TerminalDocumentModes = {
bracketedPasteMode: boolean
altScreen: boolean
mouseTrackingMode: string
sgrMouseMode: boolean
sgrMousePixelsMode: boolean
applicationCursorKeysMode: boolean
kittyKeyboardFlags: number
modifyOtherKeys: number
}
export type TerminalWriteQueueEntry = string | (() => void) | undefined
// Each document needs fresh state so remounts cannot inherit prior terminal state.
function createTerminalDocumentState(): TerminalDocumentState {
return {
term: null,
panX: 0,
panY: 0,
terminalGeneration: 0,
termObserverDisposables: [],
initRows: 24,
webglAddon: null,
webglRecoveryTimer: null,
terminalThemeInput: null,
defaultTheme: DEFAULT_TERMINAL_THEME,
terminalTheme: DEFAULT_TERMINAL_THEME,
terminalMinimumContrastRatio: 3,
initialOscLinks: [],
initialOscLinkRowOffset: 0,
lastEmittedModes: {
bracketedPasteMode: false,
altScreen: false,
mouseTrackingMode: 'none',
sgrMouseMode: false,
sgrMousePixelsMode: false,
applicationCursorKeysMode: false,
kittyKeyboardFlags: 0,
modifyOtherKeys: 0
},
everReady: false,
mouseEncodingKnown: false,
mouseModeScanTail: '',
trackedMouseTrackingMode: 'none',
sgrMouseMode: false,
sgrMousePixelsMode: false,
keyboardModes: new TerminalKittyKeyboardModeTracker(),
scrollIndicatorHideTimer: null,
handledMessageIds: [],
currentTextScale: 1,
terminalFontFamily: '',
firstDataPending: false,
reportedCellBox: null,
activeAltScreenSnapshot: false,
currentScale: 1,
userScale: 1,
statusDotPendingSelector: false,
writeQueue: [],
writeQueueHead: 0,
writesDraining: false,
afterDrainCallbacks: [],
ready: false,
smoothScrollOffsetY: 0,
pendingNormalScrollDeltaY: 0,
normalScrollFrameId: null,
selMenu: null,
btnCopy: null,
btnSelAll: null,
edgeScrollTimer: null,
edgeScrollDir: 0,
edgeScrollClientX: 0,
edgeScrollClientY: 0,
initialOscLinkEvictionReady: false,
selectionOverlay: null,
handleStart: null,
handleEnd: null,
selMode: 'navigate',
sel: null,
longPressTimer: null,
longPressOrigin: null,
interactionActive: true,
tapCandidate: null,
wheelAccumDeltaY: 0,
bottomRowBackdrop: '',
surface: null,
pendingTerm: null,
pendingReplayScrollAnchorRows: null,
committedTerm: null,
provisionalTerm: null,
committedSurface: null,
pendingSurface: null,
scrollIndicator: null,
scrollThumb: null,
terminalDataRepliesEnabled: false,
linesEverWritten: 0,
nonFatalErrorNotifies: 0,
uninstallErrorReporter: null,
uninstallHostTransport: null,
cancelFontReadiness: null,
removeViewportRefit: null,
removeTapDispatch: null,
removeWebglRecovery: null,
fitRetryToken: 0,
hostFrame: null,
fitPending: null,
mouseGesture: null,
touchDispatch: {
mode: 'idle',
touchId: null,
touchIds: null,
longPressFingerInsideOverlay: false
},
scheduledFrames: [],
framesStopped: false,
touchGesture: {
active: false,
lastX: 0,
lastY: 0,
lastTime: 0,
velY: 0,
accumDelta: 0,
momentumId: null,
isPinching: false,
pinchDist: 0,
pinchScale: 0,
pinchSurfX: 0,
pinchSurfY: 0
}
}
}
function createTerminalDocumentHostSeams(): TerminalDocumentHostSeams {
return {
postToHost: postToReactNativeWebView,
createTerminal: createEngineTerminal,
createUnicode11Addon: createEngineUnicode11Addon,
createWebglAddon: createEngineWebglAddon,
installErrorReporter: installWindowErrorReporter,
capturedEngineErrors: windowCapturedEngineErrors,
paintDocumentBackground: paintWindowDocumentBackground,
installHostTransport: installWindowHostTransport,
hasEngine: windowHasEngine,
start: windowStart,
viewportRect: windowViewportRect,
observeViewport: observeWindowViewport,
root: null
}
}
export function createTerminalDocumentScope(
host: TerminalDocumentHost = {}
): TerminalDocumentScope {
const named = Object.fromEntries(Object.entries(host).filter(([, hook]) => hook !== undefined))
return { ...createTerminalDocumentState(), ...createTerminalDocumentHostSeams(), ...named }
}