feat(deps): make uipath-ipc a required dependency

packages/uipath/pyproject.toml

@@ -1,13 +1,14 @@
 [project]
 name = "uipath"
-version = "2.14.19"
+version = "2.14.20"
 description = "Python SDK and CLI for UiPath Platform, enabling programmatic interaction with automation services, process management, and deployment tools."
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.11"
 dependencies = [
   "uipath-core>=0.5.30, <0.6.0",
   "uipath-runtime>=0.13.5, <0.14.0",
   "uipath-platform>=0.2.30, <0.3.0",
+  "uipath-ipc>=2.5.1, <2.6.0",
   "click>=8.3.3, <9.0.0",
   "httpx>=0.28.1",
   "pyjwt>=2.13.0, <3.0.0",
@@ -46,6 +47,7 @@ Documentation = "https://uipath.github.io/uipath-python/"
 [project.scripts]
 uipath = "uipath._cli:cli"
 
+# Kept so an existing `uipath[ipc]` requirement still resolves; uipath-ipc is a base dependency now.
 [project.optional-dependencies]
 ipc = ["uipath-ipc>=2.5.1,<2.6.0"]
 
@@ -82,7 +84,6 @@ dev = [
   "types-PyYAML>=6.0",
   "pytest-timeout>=2.4.0",
   "packaging>=24.0",
-  "uipath-ipc>=2.5.1,<2.6.0",
 ]
 
 [tool.hatch.build.targets.wheel]

packages/uipath/src/uipath/_cli/_job_api.py

@@ -346,12 +346,7 @@ def connect_handler_ipc(pipe: str, job_id: str | None) -> _HandlerIpcConnection:
             f"--handler-ipc-pipe needs UIPATH_JOB_KEY to be a job id; got {job_id!r}."
         )
 
-    try:
-        from uipath_ipc import IpcClient, NamedPipeClientTransport
-    except ImportError as e:
-        raise RuntimeError(
-            "--handler-ipc-pipe requires the 'uipath-ipc' package. Install it (pip install 'uipath[ipc]')."
-        ) from e
+    from uipath_ipc import IpcClient, NamedPipeClientTransport
 
     loop = _new_ipc_event_loop()
     thread = threading.Thread(

packages/uipath/src/uipath/_cli/cli_server_ipc.py

@@ -9,7 +9,8 @@
 if TYPE_CHECKING:
     from uipath_ipc import Message
 else:
-    # Optional dep: the annotation stays a string forward-ref, so this placeholder is never subscripted.
+    # uipath-ipc is a base dependency, so this only fires on a broken install. The annotation stays a
+    # string forward-ref, so this placeholder is never subscripted.
     try:
         from uipath_ipc import Message
     except ImportError:  # pragma: no cover - no IPC means Register is never dispatched
@@ -165,14 +166,7 @@ async def StopJob(self, request: PythonServerStopJobRequest) -> bool:
 
 async def start_ipc_server(pipe_name: str) -> None:
     """Serve the Python runtime over a uipath-ipc named pipe until it is closed."""
-    try:
-        from uipath_ipc import IpcServer, NamedPipeServerTransport
-    except ImportError as e:
-        raise RuntimeError(
-            "The uipath-ipc channel was requested (--ipc-pipe) but the 'uipath-ipc' "
-            "package is not installed in this environment. Install it (pip install "
-            "'uipath[ipc]') or omit --ipc-pipe to serve HTTP only."
-        ) from e
+    from uipath_ipc import IpcServer, NamedPipeServerTransport
 
     _state.init()
 

packages/uipath/tests/cli/test_job_api.py

@@ -443,12 +443,6 @@ def live() -> int:
     assert live() == before
 
 
-def test_connect_without_uipath_ipc_raises(monkeypatch):
-    monkeypatch.setitem(sys.modules, "uipath_ipc", None)
-    with pytest.raises(RuntimeError, match="uipath-ipc"):
-        _job_api.connect_handler_ipc("pipe", JOB_ID)
-
-
 def test_a_broken_log_channel_is_reported_once_to_stderr(monkeypatch):
     _isolated_output_sinks(monkeypatch)
 

packages/uipath/tests/cli/test_server_ipc.py

@@ -15,7 +15,6 @@
 import json
 import logging
 import os
-import sys
 import threading
 import time
 from typing import Any, Awaitable, Callable, cast
@@ -120,14 +119,6 @@ def main(input: Input) -> str:
 """
 
 
-def test_start_ipc_server_fails_fast_without_uipath_ipc(monkeypatch):
-    """--ipc-pipe with uipath-ipc absent must fail loudly, not silently no-op."""
-    monkeypatch.setitem(sys.modules, "uipath_ipc", None)
-    coro = start_ipc_server(_unique_pipe())
-    with pytest.raises(RuntimeError, match="uipath-ipc"):
-        asyncio.run(coro)
-
-
 JOB_ID = "3f2504e0-4f89-11d3-9a0c-0305e82c3301"