Function useDesktopConnection

site/src/pages/AgentsPage/hooks/useDesktopConnection.ts:82–511

({
	chatId,
	activated,
}: UseDesktopConnectionOptions)

};

export function useDesktopConnection({
	chatId,
	activated,
}: UseDesktopConnectionOptions): UseDesktopConnectionResult {
	const [status, setStatus] = useState<DesktopConnectionStatus>("idle");
	const [hasConnected, setHasConnected] = useState(false);
	const [remoteClipboardText, setRemoteClipboardText] = useState<string | null>(
		null,
	);

	// rfbRef provides synchronous access for cleanup and event
	// handlers. rfbInstance (state) provides reactivity so consumers
	// re-render when the RFB instance changes.
	const [rfbInstance, setRfbInstance] = useState<RFB | null>(null);
	const rfbRef = useRef<RFB | null>(null);

	const offscreenContainerRef = useRef<HTMLElement | null>(null);
	const reconnectAttemptRef = useRef(0);
	const reconnectTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
	const reconnectStableTimerRef = useRef<ReturnType<typeof setTimeout> | null>(
		null,
	);
	const connectTimeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);
	// Monotonically increasing counter. Incremented at the start of
	// every doConnect() and inside the cleanup. Event handlers
	// capture the current value and bail when it no longer matches,
	// which prevents async noVNC callbacks from a previous session
	// (e.g. a phantom "disconnect" event fired after cleanupRfb)
	// from scheduling unwanted reconnect timers.
	const generationRef = useRef(0);

	// Populated by the lifecycle effect so reconnect() can tear
	// down and restart the connection from outside the effect.
	// Cleared on cleanup so calls after unmount are no-ops.
	const restartRef = useRef<(() => void) | null>(null);

	const reconnect = () => {
		restartRef.current?.();
	};
	const { copyToClipboard: syncRemoteClipboardToLocal } = useClipboard({
		onError: () => {
			toast.error(
				"Failed to sync the remote clipboard to your local clipboard.",
			);
		},
	});

	const attach = (container: HTMLElement) => {
		const screen = offscreenContainerRef.current;
		if (screen && screen.parentElement !== container) {
			container.appendChild(screen);
		}
	};
	// Single lifecycle effect that owns the entire connection.
	// Connects on mount, tears down on unmount, and resets when
	// chatId changes.
	//
	// All connection logic (doConnect, cleanupRfb, timer helpers)