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 { useEffect } from 'react'
import { translate } from '../i18n/mobile-i18n'
import { worktreeActivate } from '../host-screen/host-screen-operations'
import { headlessActivationNeedsHostRenderer } from '../worktree/worktree-activation-result'
import { createInitialSessionAutoCreateState } from './use-initial-session-terminal-autocreate'
import type { MobileSessionKeyboardStateModel } from './use-mobile-session-keyboard-state'
import type { RpcResponse } from '../transport/types'
export function useMobileSessionStartup(scope: MobileSessionKeyboardStateModel) {
const {
hostId,
worktreeId,
created,
isFloatingWorkspaceRoute,
connState,
client,
setTerminals,
terminalsRef,
setSessionTabs,
appliedSnapshotMarkerRef,
closedTabTombstonesRef,
setTerminalsLoaded,
setActiveHandle,
setActiveSessionTabId,
setMarkdownDocs,
setFileDocs,
terminalGestureInputQueuesRef,
terminalGestureInputInFlightRef,
sessionTabActionSheetKeyboardHideSubRef,
sessionTabActionSheetRequestSeqRef,
initializedHandlesRef,
terminalDiagnosticsRef,
activeHandleRef,
activeSessionTabTypeRef,
pendingSelectionRef,
selectedSessionTabIdRef,
pendingBrowserFocusPageIdRef,
pendingTerminalActivationAttemptRef,
initialSessionAutoCreateRef,
bufferedTerminalDraftState,
clearPendingLiveInputCommit,
clearDelayedActionTimers,
showToast,
clearTerminalCache,
fetchTerminals,
ensureSessionTabs
} = scope
useEffect(() => {
// Reset reused-route state so the next workspace cannot inherit stale UI or snapshot gates.
sessionTabActionSheetRequestSeqRef.current += 1
sessionTabActionSheetKeyboardHideSubRef.current?.remove()
sessionTabActionSheetKeyboardHideSubRef.current = null
clearTerminalCache()
activeHandleRef.current = null
activeSessionTabTypeRef.current = null
pendingSelectionRef.current = null
selectedSessionTabIdRef.current = null
pendingBrowserFocusPageIdRef.current = null
pendingTerminalActivationAttemptRef.current = null
initialSessionAutoCreateRef.current = createInitialSessionAutoCreateState()
terminalDiagnosticsRef.current.resetRoute()
appliedSnapshotMarkerRef.current = { epoch: null, version: -1 }
closedTabTombstonesRef.current.clear()
bufferedTerminalDraftState.resetDrafts()
for (const queued of terminalGestureInputQueuesRef.current.values()) {
if (queued.timer) {
clearTimeout(queued.timer)
}
}
terminalGestureInputQueuesRef.current.clear()
terminalGestureInputInFlightRef.current.clear()
setActiveHandle(null)
setTerminals([])
terminalsRef.current = []
setSessionTabs([])
setActiveSessionTabId(null)
clearPendingLiveInputCommit()
setMarkdownDocs(new Map())
setFileDocs(new Map())
clearDelayedActionTimers()
return () => {
sessionTabActionSheetRequestSeqRef.current += 1
sessionTabActionSheetKeyboardHideSubRef.current?.remove()
bufferedTerminalDraftState.clearPendingRestorations()
clearPendingLiveInputCommit()
clearDelayedActionTimers()
}
}, [
clearDelayedActionTimers,
clearPendingLiveInputCommit,
bufferedTerminalDraftState.clearPendingRestorations,
clearTerminalCache,
hostId,
bufferedTerminalDraftState.resetDrafts,
worktreeId
])
// Every setTimeout goes through addTimer into `timers`, which the returned cleanup clears.
// react-doctor-disable-next-line react-doctor/effect-needs-cleanup
useEffect(() => {
if (connState !== 'connected') {
return
}
// Keep xterm visible while reconnect history hydrates.
if (initializedHandlesRef.current.size === 0) {
setTerminalsLoaded(false)
}
// Clear initialization so reconnect scrollback replaces stale content instead of being ignored.
initializedHandlesRef.current.clear()
let disposed = false
const timers: ReturnType<typeof setTimeout>[] = []
function addTimer(fn: () => void, ms: number) {
if (disposed) {
return
}
timers.push(setTimeout(fn, ms))
}
void (async () => {
// Interpret only actual replies; preserve absent activation replies as null rather than inventing refusals.
const reportActivationOutcome = (response: RpcResponse | null): void => {
const activation = response === null ? null : worktreeActivate.interpret(response)
if (
!disposed &&
activation?.accepted === true &&
headlessActivationNeedsHostRenderer(activation.value)
) {
showToast(
translate(
'session.useStartup.wakeAgents',
'Open Orca on the host to wake sleeping agents.'
),
3000
)
}
}
if (client && created !== '1' && !isFloatingWorkspaceRoute) {
// Hydrate tabs without navigating other paired clients into this workspace.
void worktreeActivate
.request(client, {
worktree: `id:${worktreeId}`,
notifyClients: false,
navigation: 'caller'
})
.then(reportActivationOutcome)
.catch(() => null)
}
if (disposed) {
return
}
await ensureSessionTabs().catch(() => null)
if (disposed) {
return
}
await fetchTerminals({ allowEmptyLoaded: false })
if (disposed) {
return
}
addTimer(() => void fetchTerminals({ allowEmptyLoaded: false }), 750)
addTimer(() => void fetchTerminals({ allowEmptyLoaded: true }), 1500)
if (client && created === '1' && !isFloatingWorkspaceRoute) {
addTimer(() => {
if (activeHandleRef.current) {
return
}
void (async () => {
const activationResponse = await worktreeActivate
.request(client, {
worktree: `id:${worktreeId}`,
notifyClients: false,
navigation: 'caller'
})
.catch(() => null)
reportActivationOutcome(activationResponse)
if (disposed) {
return
}
await fetchTerminals({ allowEmptyLoaded: true })
addTimer(() => void fetchTerminals({ allowEmptyLoaded: true }), 750)
})()
}, 1800)
}
})()
return () => {
disposed = true
for (const t of timers) {
clearTimeout(t)
}
}
}, [
client,
connState,
created,
fetchTerminals,
ensureSessionTabs,
isFloatingWorkspaceRoute,
showToast,
worktreeId
])
}