uipath-langchain-client 1.0.0__tar.gz

uipath_langchain_client-1.0.0/.gitignore

@@ -0,0 +1,211 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+#poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+#pdm.lock
+#pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+#pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Abstra
+# Abstra is an AI-powered process automation framework.
+# Ignore directories containing user credentials, local state, and settings.
+# Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#  you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor
+#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
+#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+#  refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+.vscode/
+.DS_Store
+.uipath/

uipath_langchain_client-1.0.0/CHANGELOG.md

@@ -0,0 +1,90 @@
+# UiPath LangChain Client Changelog
+
+All notable changes to `uipath_langchain_client` will be documented in this file.
+
+## [1.0.0] - 2025-01-30
+
+### Official Release
+- First stable release of the UiPath LangChain Client
+- API considered stable; semantic versioning will be followed from this point forward
+
+### Highlights
+- Production-ready LangChain integrations for all major LLM providers
+- Factory functions for automatic vendor detection and model instantiation
+- Full compatibility with LangChain agents, tools, and chains
+- Comprehensive support for chat completions, embeddings, and streaming
+- Seamless integration with both AgentHub and LLMGateway backends
+
+## [0.3.x] - 2025-01-29
+
+### Release
+- First public release of the UiPath LangChain Client
+- Production-ready integration with LangChain ecosystem
+
+### Documentation
+- Complete rewrite of README.md with installation, quick start, and API reference
+- Added comprehensive usage examples for all supported providers
+- Added module-level and class-level docstrings throughout the codebase
+
+### Features
+- Factory functions (`get_chat_model`, `get_embedding_model`) for auto-detecting model vendors
+- Normalized API support for provider-agnostic chat completions and embeddings
+- Full compatibility with LangChain agents and tools
+
+### Supported Providers
+- OpenAI
+- Google
+- Anthropic
+- AWS Bedrock
+- Vertex AI
+- Azure AI
+
+## [0.2.x] - 2025-01-15
+
+### Architecture
+- Extracted from monolithic package into dedicated LangChain integration package
+- Now depends on `uipath_llm_client` core package for HTTP client and authentication
+- Unified client architecture supporting both AgentHub and LLMGateway backends
+
+### Chat Model Classes
+- `UiPathChatOpenAI` - OpenAI models via direct API
+- `UiPathAzureChatOpenAI` - OpenAI models via Azure
+- `UiPathChatGoogleGenerativeAI` - Google Gemini models
+- `UiPathChatAnthropic` - Anthropic Claude models
+- `UiPathChatAnthropicVertex` - Claude models via Google VertexAI
+- `UiPathChatBedrock` - AWS Bedrock models
+- `UiPathChatBedrockConverse` - AWS Bedrock Converse API
+- `UiPathAzureAIChatCompletionsModel` - Azure AI models (non-OpenAI)
+- `UiPathNormalizedChatModel` - Provider-agnostic normalized API
+
+### Embeddings Classes
+- `UiPathOpenAIEmbeddings` - OpenAI embeddings via direct API
+- `UiPathAzureOpenAIEmbeddings` - OpenAI embeddings via Azure
+- `UiPathGoogleGenerativeAIEmbeddings` - Google embeddings
+- `UiPathBedrockEmbeddings` - AWS Bedrock embeddings
+- `UiPathAzureAIEmbeddingsModel` - Azure AI embeddings
+- `UiPathNormalizedEmbeddings` - Provider-agnostic normalized API
+
+### Features
+- Support for BYO (Bring Your Own) model connections
+
+### Breaking Changes
+- Package renamed from internal module to `uipath_langchain_client`
+- Import paths changed; update imports accordingly
+
+## [0.1.x] - 2024-12-20
+
+### Initial Development Release
+- LangChain-compatible chat models wrapping UiPath LLM services
+- Passthrough clients for:
+  - OpenAI
+  - Google Gemini
+  - Anthropic
+  - AWS Bedrock
+  - Vertex AI
+  - Azure AI
+- Embeddings support for text-embedding models
+- Streaming support (sync and async)
+- Tool/function calling support
+- Full compatibility with LangChain's `BaseChatModel` interface
+- httpx-based HTTP handling for consistent behavior

uipath_langchain_client-1.0.0/PKG-INFO

@@ -0,0 +1,276 @@
+Metadata-Version: 2.4
+Name: uipath-langchain-client
+Version: 1.0.0
+Summary: LangChain-compatible chat models and embeddings for UiPath's LLM services
+Requires-Python: >=3.11
+Requires-Dist: langchain>=1.2.7
+Requires-Dist: uipath-llm-client>=1.0.0
+Provides-Extra: all
+Requires-Dist: langchain-anthropic>=1.3.1; extra == 'all'
+Requires-Dist: langchain-aws>=1.2.1; extra == 'all'
+Requires-Dist: langchain-azure-ai>=1.0.0; extra == 'all'
+Requires-Dist: langchain-google-genai>=4.2.0; extra == 'all'
+Requires-Dist: langchain-google-vertexai>=3.2.1; extra == 'all'
+Requires-Dist: langchain-openai>=1.1.7; extra == 'all'
+Provides-Extra: anthropic
+Requires-Dist: langchain-anthropic>=1.3.1; extra == 'anthropic'
+Provides-Extra: aws
+Requires-Dist: langchain-aws>=1.2.1; extra == 'aws'
+Provides-Extra: azure
+Requires-Dist: langchain-azure-ai>=1.0.0; extra == 'azure'
+Provides-Extra: google
+Requires-Dist: langchain-google-genai>=4.2.0; extra == 'google'
+Provides-Extra: openai
+Requires-Dist: langchain-openai>=1.1.7; extra == 'openai'
+Provides-Extra: vertexai
+Requires-Dist: langchain-google-vertexai>=3.2.1; extra == 'vertexai'
+Description-Content-Type: text/markdown
+
+# UiPath LangChain Client
+
+LangChain-compatible chat models and embeddings for accessing LLMs through UiPath's infrastructure.
+
+## Installation
+
+```bash
+# Base installation (normalized API only)
+pip install uipath-langchain-client
+
+# With specific provider extras for passthrough mode
+pip install "uipath-langchain-client[openai]"      # OpenAI/Azure models
+pip install "uipath-langchain-client[google]"      # Google Gemini models
+pip install "uipath-langchain-client[anthropic]"   # Anthropic Claude models
+pip install "uipath-langchain-client[azure]"       # Azure AI models
+pip install "uipath-langchain-client[aws]"         # AWS Bedrock models
+pip install "uipath-langchain-client[vertexai]"    # Google VertexAI models
+pip install "uipath-langchain-client[all]"         # All providers
+```
+
+## Quick Start
+
+### Using Factory Functions (Recommended)
+
+The factory functions automatically detect the model vendor and return the appropriate client:
+
+```python
+from uipath_langchain_client import get_chat_model, get_embedding_model
+from uipath_langchain_client.settings import get_default_client_settings
+
+# Get default settings (uses UIPATH_LLM_BACKEND env var or defaults to AgentHub)
+settings = get_default_client_settings()
+
+# Chat model - vendor auto-detected from model name
+chat_model = get_chat_model(
+    model_name="gpt-4o-2024-11-20",
+    client_settings=settings,
+)
+response = chat_model.invoke("Hello, how are you?")
+print(response.content)
+
+# Embeddings model
+embeddings = get_embedding_model(
+    model="text-embedding-3-large",
+    client_settings=settings,
+)
+vectors = embeddings.embed_documents(["Hello world"])
+print(f"Embedding dimension: {len(vectors[0])}")
+```
+
+### Using Direct Client Classes
+
+For more control, instantiate provider-specific classes directly:
+
+```python
+from uipath_langchain_client.openai.chat_models import UiPathAzureChatOpenAI
+from uipath_langchain_client.google.chat_models import UiPathChatGoogleGenerativeAI
+from uipath_langchain_client.anthropic.chat_models import UiPathChatAnthropic
+from uipath_langchain_client.normalized.chat_models import UiPathNormalizedChatModel
+from uipath_langchain_client.settings import get_default_client_settings
+
+settings = get_default_client_settings()
+
+# OpenAI/Azure
+openai_chat = UiPathAzureChatOpenAI(model="gpt-4o-2024-11-20", client_settings=settings)
+
+# Google Gemini
+gemini_chat = UiPathChatGoogleGenerativeAI(model="gemini-2.5-flash", client_settings=settings)
+
+# Anthropic Claude (via AWS Bedrock)
+claude_chat = UiPathChatAnthropic(
+    model="anthropic.claude-sonnet-4-5-20250929-v1:0",
+    client_settings=settings,
+    vendor_type="awsbedrock",
+)
+
+# Normalized (provider-agnostic)
+normalized_chat = UiPathNormalizedChatModel(model="gpt-4o-2024-11-20", client_settings=settings)
+```
+
+## Available Client Types
+
+### Passthrough Mode (Default)
+
+Uses vendor-specific APIs through UiPath's gateway. Full feature parity with native SDKs.
+
+| Class | Provider | Models |
+|-------|----------|--------|
+| `UiPathAzureChatOpenAI` | OpenAI/Azure | GPT-4o, GPT-4, GPT-3.5 |
+| `UiPathChatOpenAI` | OpenAI | GPT-4o, GPT-4, GPT-3.5 |
+| `UiPathChatGoogleGenerativeAI` | Google | Gemini 2.5, 2.0, 1.5 |
+| `UiPathChatAnthropic` | Anthropic | Claude Sonnet 4.5, Opus, etc. |
+| `UiPathChatAnthropicVertex` | Anthropic (via VertexAI) | Claude models |
+| `UiPathAzureAIChatCompletionsModel` | Azure AI | Various |
+
+### Normalized Mode
+
+Uses UiPath's normalized API for a consistent interface across all providers.
+
+| Class | Description |
+|-------|-------------|
+| `UiPathNormalizedChatModel` | Provider-agnostic chat completions |
+| `UiPathNormalizedEmbeddings` | Provider-agnostic embeddings |
+
+## Features
+
+### Streaming
+
+```python
+from uipath_langchain_client import get_chat_model
+from uipath_langchain_client.settings import get_default_client_settings
+
+settings = get_default_client_settings()
+chat_model = get_chat_model(model_name="gpt-4o-2024-11-20", client_settings=settings)
+
+# Sync streaming
+for chunk in chat_model.stream("Write a haiku about Python"):
+    print(chunk.content, end="", flush=True)
+
+# Async streaming
+async for chunk in chat_model.astream("Write a haiku about Python"):
+    print(chunk.content, end="", flush=True)
+```
+
+### Tool Calling
+
+```python
+from langchain_core.tools import tool
+
+@tool
+def get_weather(city: str) -> str:
+    """Get the current weather for a city."""
+    return f"Sunny, 72°F in {city}"
+
+chat_model = get_chat_model(model_name="gpt-4o-2024-11-20", client_settings=settings)
+model_with_tools = chat_model.bind_tools([get_weather])
+
+response = model_with_tools.invoke("What's the weather in Tokyo?")
+print(response.tool_calls)
+```
+
+### LangGraph Agents
+
+```python
+from langgraph.prebuilt import create_react_agent
+from langchain_core.tools import tool
+
+@tool
+def search(query: str) -> str:
+    """Search the web."""
+    return f"Results for: {query}"
+
+chat_model = get_chat_model(model_name="gpt-4o-2024-11-20", client_settings=settings)
+agent = create_react_agent(chat_model, [search])
+
+result = agent.invoke({"messages": [("user", "Search for UiPath documentation")]})
+```
+
+### Extended Thinking (Model-Specific)
+
+```python
+# OpenAI o1/o3 reasoning
+chat_model = get_chat_model(
+    model_name="o3-mini",
+    client_settings=settings,
+    client_type="normalized",
+    reasoning_effort="medium",  # "low", "medium", "high"
+)
+
+# Anthropic Claude thinking
+chat_model = get_chat_model(
+    model_name="claude-sonnet-4-5",
+    client_settings=settings,
+    client_type="normalized",
+    thinking={"type": "enabled", "budget_tokens": 10000},
+)
+
+# Gemini thinking
+chat_model = get_chat_model(
+    model_name="gemini-2.5-pro",
+    client_settings=settings,
+    client_type="normalized",
+    thinking_level="medium",
+    include_thoughts=True,
+)
+```
+
+## Configuration
+
+### Retry Configuration
+
+```python
+# RetryConfig is a TypedDict - all fields are optional with sensible defaults
+retry_config = {
+    "initial_delay": 2.0,   # Initial delay before first retry
+    "max_delay": 60.0,      # Maximum delay between retries
+    "exp_base": 2.0,        # Exponential backoff base
+    "jitter": 1.0,          # Random jitter to add
+}
+
+chat_model = get_chat_model(
+    model_name="gpt-4o-2024-11-20",
+    client_settings=settings,
+    max_retries=3,
+    retry_config=retry_config,
+)
+```
+
+### Request Timeout
+
+```python
+chat_model = get_chat_model(
+    model_name="gpt-4o-2024-11-20",
+    client_settings=settings,
+    request_timeout=120,  # Client-side timeout in seconds
+)
+```
+
+## API Reference
+
+### `get_chat_model()`
+
+Factory function to create a chat model.
+
+**Parameters:**
+- `model_name` (str): Name of the model (e.g., "gpt-4o-2024-11-20")
+- `client_settings` (UiPathBaseSettings): Client settings for authentication
+- `client_type` (Literal["passthrough", "normalized"]): API mode (default: "passthrough")
+- `**model_kwargs`: Additional arguments passed to the model constructor
+
+**Returns:** `BaseChatModel` - A LangChain-compatible chat model
+
+### `get_embedding_model()`
+
+Factory function to create an embeddings model.
+
+**Parameters:**
+- `model` (str): Name of the model (e.g., "text-embedding-3-large")
+- `client_settings` (UiPathBaseSettings): Client settings for authentication
+- `client_type` (Literal["passthrough", "normalized"]): API mode (default: "passthrough")
+- `**model_kwargs`: Additional arguments passed to the model constructor
+
+**Returns:** `Embeddings` - A LangChain-compatible embeddings model
+
+## See Also
+
+- [Main README](../../README.md) - Overview and core client documentation
+- [UiPath LLM Client](../../src/uipath_llm_client/) - Low-level HTTP client