Feat: LiteLLM integration (#58)

Author: cosminacho

CHANGELOG.md

@@ -2,6 +2,23 @@
 
 All notable changes to `uipath_llm_client` (core package) will be documented in this file.
 
+## [1.8.0] - 2026-04-08
+
+### Added
+- `UiPathLiteLLM` — provider-agnostic LLM client powered by LiteLLM
+  - `completion` / `acompletion` for chat completions across all providers
+  - `embedding` / `aembedding` for embeddings
+  - Automatic model discovery from the UiPath backend — detects vendor, api_flavor, and model family
+  - Optional `vendor_type` and `api_flavor` overrides (same pattern as LangChain factory)
+  - Supports OpenAI (chat-completions + responses API), Gemini, Bedrock (invoke + converse), and Vertex AI Claude
+  - All HTTP routed through UiPath httpx transport (auth, retry, headers) — no direct calls to Google/AWS/OpenAI
+  - Explicit completion parameters with full IDE autocomplete
+- `litellm` as an optional dependency (`uv add uipath-llm-client[litellm]`)
+- `_strict_response_validation` parameter to all Anthropic client classes
+
+### Changed
+- Updated dependency versions: `uipath-platform>=0.1.21`, `anthropic>=0.91.0`, `litellm>=1.83.4`
+
 ## [1.7.0] - 2026-04-03
 
 ### Added

README.md

@@ -1,14 +1,13 @@
 # UiPath LLM Client
 
-A Python client for interacting with UiPath's LLM services. This package provides both a low-level HTTP client and framework-specific integrations (LangChain, LlamaIndex) for accessing LLMs through UiPath's infrastructure.
+A Python client for interacting with UiPath's LLM services. This package provides both a low-level HTTP client and a LangChain integration for accessing LLMs through UiPath's infrastructure.
 
 ## Architecture Overview
 
 This repository is organized as a monorepo with the following packages:
 
 - **`uipath_llm_client`** (root): Core HTTP client with authentication, retry logic, and request handling
 - **`uipath_langchain_client`** (packages/): LangChain-compatible chat models and embeddings
-- **`uipath_llamaindex_client`** (packages/): LlamaIndex-compatible integrations
 
 ### Supported Backends
 
@@ -816,7 +815,7 @@ uv run pyright
 
 ### Testing
 
-Tests use [VCR.py](https://vcrpy.readthedocs.io/) to record and replay HTTP interactions. Cassettes (recorded responses) are stored in `tests/cassettes/` using Git LFS.
+Tests use [VCR.py](https://vcrpy.readthedocs.io/) to record and replay HTTP interactions. Cassettes (recorded responses) are stored in `tests/cassettes.db` (SQLite) via `pytest-recording`.
 
 **Important:** Tests must pass locally before submitting a PR. The CI pipeline does not make any real API requests—it only runs tests using the pre-recorded cassettes.
 
@@ -855,7 +854,9 @@ uipath-llm-client/
 │   ├── clients/                        # Native SDK wrappers
 │   │   ├── openai/                     # UiPathOpenAI, UiPathAzureOpenAI, etc.
 │   │   ├── anthropic/                  # UiPathAnthropic, UiPathAnthropicBedrock, etc.
-│   │   └── google/                     # UiPathGoogle
+│   │   ├── google/                     # UiPathGoogle
+│   │   ├── normalized/                 # UiPathNormalizedClient (provider-agnostic)
+│   │   └── litellm/                    # UiPathLiteLLM (via LiteLLM)
 │   ├── settings/                       # Backend-specific settings & auth
 │   │   ├── base.py                     # UiPathBaseSettings, UiPathAPIConfig
 │   │   ├── platform/                   # PlatformSettings, PlatformAuth
@@ -878,9 +879,9 @@ uipath-llm-client/
 │   │           ├── vertexai/           # UiPathChatAnthropicVertex
 │   │           ├── bedrock/            # UiPathChatBedrock, UiPathChatBedrockConverse
 │   │           ├── fireworks/          # UiPathChatFireworks, UiPathFireworksEmbeddings
+│   │           ├── litellm/           # UiPathChatLiteLLM, UiPathLiteLLMEmbeddings
 │   │           └── azure/              # UiPathAzureAIChatCompletionsModel
-│   └── uipath_llamaindex_client/       # LlamaIndex integration (planned)
-└── tests/                              # Test suite with VCR cassettes
+└── tests/                              # Test suite with VCR cassettes (SQLite)
 ```
 
 ## License

packages/uipath_langchain_client/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to `uipath_langchain_client` will be documented in this file.
 
+## [1.8.0] - 2026-04-08
+
+### Added
+- `UiPathChatLiteLLM` — LangChain chat model powered by LiteLLM, supporting all UiPath gateway providers
+- `langchain-litellm` as an optional dependency for LiteLLM integration
+
+### Changed
+- Updated dependency versions: `anthropic[bedrock,vertex]>=0.91.0`
+- Version bump to match core package 1.8.0
+
 ## [1.7.1] - 2026-04-04
 
 ### Added

packages/uipath_langchain_client/pyproject.toml

@@ -5,35 +5,38 @@ dynamic = ["version"]
 readme = "README.md"
 requires-python = ">=3.11"
 dependencies = [
-    "langchain>=1.2.13",
-    "uipath-llm-client>=1.7.0",
+    "langchain>=1.2.15",
+    "uipath-llm-client>=1.8.0",
 ]
 
 [project.optional-dependencies]
 openai = [
-    "langchain-openai>=1.1.11",
+    "langchain-openai>=1.1.12",
 ]
 google = [
     "langchain-google-genai>=4.2.1",
 ]
 anthropic = [
     "langchain-anthropic>=1.4.0",
-    "anthropic[bedrock,vertex]>=0.86.0",
+    "anthropic[bedrock,vertex]>=0.91.0",
 ]
 aws = [
-    "langchain-aws[anthropic]>=1.4.1",
+    "langchain-aws[anthropic]>=1.4.3",
 ]
 vertexai = [
     "langchain-google-vertexai>=3.2.2",
 ]
 azure = [
-    "langchain-azure-ai>=1.1.1",
+    "langchain-azure-ai>=1.2.1",
 ]
 fireworks = [
     "langchain-fireworks>=1.1.0",
 ]
+litellm = [
+    "langchain-litellm>=0.6.4",
+]
 all = [
-    "uipath-langchain-client[openai,aws,google,anthropic,azure,vertexai,fireworks]"
+    "uipath-langchain-client[openai,aws,google,anthropic,azure,vertexai,fireworks,litellm]"
 ]
 
 [build-system]

packages/uipath_langchain_client/src/uipath_langchain_client/__version__.py

@@ -1,3 +1,3 @@
 __title__ = "UiPath LangChain Client"
 __description__ = "A Python client for interacting with UiPath's LLM services via LangChain."
-__version__ = "1.7.1"
+__version__ = "1.8.0"

packages/uipath_langchain_client/src/uipath_langchain_client/clients/__init__.py

@@ -1,3 +1,5 @@
+"""LangChain-compatible LLM client wrappers for UiPath providers."""
+
 from uipath_langchain_client.clients.normalized import UiPathChat, UiPathEmbeddings
 
 __all__ = [

packages/uipath_langchain_client/src/uipath_langchain_client/clients/anthropic/__init__.py

@@ -1,3 +1,10 @@
+"""LangChain chat model for Anthropic Claude via UiPath.
+
+Requires the ``anthropic`` optional extra::
+
+    uv add uipath-langchain-client[anthropic]
+"""
+
 from uipath_langchain_client.clients.anthropic.chat_models import UiPathChatAnthropic
 
 __all__ = ["UiPathChatAnthropic"]

packages/uipath_langchain_client/src/uipath_langchain_client/clients/azure/__init__.py

@@ -1,3 +1,10 @@
+"""LangChain chat models and embeddings for Azure AI via UiPath.
+
+Requires the ``azure`` optional extra::
+
+    uv add uipath-langchain-client[azure]
+"""
+
 from uipath_langchain_client.clients.azure.chat_models import UiPathAzureAIChatCompletionsModel
 from uipath_langchain_client.clients.azure.embeddings import UiPathAzureAIEmbeddingsModel
 

packages/uipath_langchain_client/src/uipath_langchain_client/clients/bedrock/__init__.py

@@ -1,3 +1,10 @@
+"""LangChain chat models and embeddings for AWS Bedrock via UiPath.
+
+Requires the ``aws`` optional extra::
+
+    uv add uipath-langchain-client[aws]
+"""
+
 from uipath_langchain_client.clients.bedrock.chat_models import (
     UiPathChatAnthropicBedrock,
     UiPathChatBedrock,

packages/uipath_langchain_client/src/uipath_langchain_client/clients/fireworks/__init__.py

@@ -1,3 +1,10 @@
+"""LangChain chat models and embeddings for Fireworks AI via UiPath.
+
+Requires the ``fireworks`` optional extra::
+
+    uv add uipath-langchain-client[fireworks]
+"""
+
 from uipath_langchain_client.clients.fireworks.chat_models import UiPathChatFireworks
 from uipath_langchain_client.clients.fireworks.embeddings import UiPathFireworksEmbeddings