fix(tools): guard Unix-only imports in terminal package for Windows (#2096)

Co-authored-by: Rb <rubenwolff@gmail.com>
Co-authored-by: Graham Neubig <neubig@gmail.com>

Author: 3 people

openhands-tools/openhands/tools/terminal/terminal/__init__.py

@@ -1,16 +1,29 @@
+import platform
+from typing import TYPE_CHECKING
+
 from openhands.tools.terminal.terminal.factory import create_terminal_session
 from openhands.tools.terminal.terminal.interface import (
     TerminalInterface,
     TerminalSessionBase,
 )
-from openhands.tools.terminal.terminal.subprocess_terminal import (
-    SubprocessTerminal,
-)
 from openhands.tools.terminal.terminal.terminal_session import (
     TerminalCommandStatus,
     TerminalSession,
 )
-from openhands.tools.terminal.terminal.tmux_terminal import TmuxTerminal
+
+
+# These backends depend on Unix-only modules (fcntl, pty, libtmux)
+if platform.system() != "Windows":
+    from openhands.tools.terminal.terminal.subprocess_terminal import (
+        SubprocessTerminal,
+    )
+    from openhands.tools.terminal.terminal.tmux_terminal import TmuxTerminal
+
+if TYPE_CHECKING:
+    from openhands.tools.terminal.terminal.subprocess_terminal import (
+        SubprocessTerminal,
+    )
+    from openhands.tools.terminal.terminal.tmux_terminal import TmuxTerminal
 
 
 __all__ = [

openhands-tools/openhands/tools/terminal/terminal/subprocess_terminal.py

@@ -1,17 +1,26 @@
 """PTY-based terminal backend implementation (replaces pipe-based subprocess)."""
 
-import fcntl
 import os
-import pty
+import platform
 import re
-import select
 import shutil
 import signal
 import subprocess
 import threading
 import time
 from collections import deque
 
+
+if platform.system() == "Windows":
+    raise ImportError(
+        "SubprocessTerminal is not supported on Windows "
+        "(requires Unix-only modules: fcntl, pty, select)"
+    )
+
+import fcntl
+import pty
+import select
+
 from openhands.sdk.logger import get_logger
 from openhands.sdk.utils import sanitized_env
 from openhands.tools.terminal.constants import (