feat(cli): add opt-in uipath-ipc transport to uipath server [ROBO-5779]

[eduard-dumitru]

Draft — Phase 1 (RPC) of adding a uipath-ipc runtime channel to uipath server, alongside a matching hdens/.NET executor change (not yet open). Not for merge yet — see Open items.

What

Adds a uipath-ipc named-pipe transport to uipath server as an opt-in, second transport — HTTP-over-socket stays the default. Transport is chosen by the UIPATH_SERVER_IPC env var (its presence selects IPC); the --server-socket arg is shared — a pipe name under IPC, a UDS path under HTTP. So the .NET executor never changes how it spawns the server, and an older runtime that predates IPC simply ignores the env var and keeps doing HTTP.

This is intentionally additive and reversible: the uipath server command is internal and consumed only by the .NET executor (SDK users, coded workflows, and agent frameworks never call it), so IPC can be validated on Linux + Windows with real jobs while HTTP remains a kill-switch. Retiring HTTP is a later phase.

Changes

• cli_server.py — one shared, transport-agnostic job core (_run_command_isolated: per-job os.environ/cwd save-set-restore, serialized by _state.lock), fronted by two edges:
  • HTTP (default, unchanged): create_app / GET /health / POST /jobs/{job_key}/start, Unix socket or TCP (--client-socket/--server-socket/--port/--tcp), ready-ACK, host-header validation.
  • IPC (opt-in): IPythonRuntimeServer (Ping / StartJob) + PythonRuntimeService over NamedPipeServerTransport, on a Windows Proactor loop. DTOs cross as PascalCase dicts (matching the .NET DTOs).
  • Selection: _should_use_ipc() = UIPATH_SERVER_IPC present AND _ipc_capability_available() — an isolated, non-failing capability seam (today: is uipath_ipc importable) so an env var set against a runtime without IPC support falls back to HTTP instead of failing. --server-socket is the pipe name in IPC mode (required there).
• pyproject.toml — adds uipath-ipc as a dependency, pinned via [tool.uv.sources] + [[tool.uv.index]] to the (anonymously accessible) UiPath-Internal Azure Artifacts feed so uv/CI can resolve it.
• tests — keeps the HTTP suite (test_server.py) and adds test_server_ipc.py (IPC: Ping / StartJob, env isolation) + test_server_transport.py (env-var selection, capability fallback, endpoint guard).

Verified locally

uv sync installs everything (incl. uipath-ipc from the anonymous feed). All three server test suites pass — HTTP, IPC, and transport-selection. ruff check, ruff format --check, and mypy are clean on the changed files. (The two test_start_job_success cases need the runtime factory the CLI registers via _ensure_runtime_initialized, which the in-process test harness bypasses — a pre-existing test-isolation quirk, green in the full suite / when the factory is registered.)

Open items / follow-ups (why this is a draft)

• Distribution — uipath-ipc is a hard dependency but currently lives only on the UiPath-Internal feed (not PyPI). A public pip install uipath needs it resolvable, so publishing uipath-ipc to PyPI is a GA prerequisite. The [tool.uv.*] config only unblocks uv/CI resolution — it is not baked into the wheel.
• .NET executor (PR A) — the matching hdens change sets UIPATH_SERVER_IPC to opt into IPC, connects an IpcClient proxy, uses Ping for readiness, and auto-falls back to HTTP against an older Python (behind a capability seam mirroring _ipc_capability_available). Required for full end-to-end.
• Cancellation — out of scope for Phase 1 (reverted); StopJobAsync stays a no-op. A future phase can add it.
• Logs — still file-tailed (execution.log); moving them onto IPC is Phase 2.

🤖 Generated with Claude Code

[github-actions]

🚨 Heads up: uipath-langchain cross-tests are FAILING 🚨

Your changes may break the uipath-langchain-python integration.

⚠️ These checks are NOT enforced by branch protection rules. Please review the failures before merging.

🔍 Inspect the failed run →

[github-actions]

🚨 Heads up: uipath-integrations cross-tests are FAILING 🚨

Your changes may break one or more integrations in uipath-integrations-python:

• uipath-openai-agents
• uipath-google-adk
• uipath-agent-framework
• uipath-llamaindex
• uipath-pydantic-ai

⚠️ These checks are NOT enforced by branch protection rules. Please review the failures before merging.

🔍 Inspect the failed run →

[sonarqubecloud]

Quality Gate failed

Failed conditions
73.7% Coverage on New Code (required ≥ 90%)

See analysis details on SonarQube Cloud