uipath-langchain 0.0.139__tar.gz → 0.0.141__tar.gz

{uipath_langchain-0.0.139 → uipath_langchain-0.0.141}/.github/workflows/integration_tests.yml

@@ -19,16 +19,16 @@ jobs:
     steps:
     - name: Checkout code
       uses: actions/checkout@v4
-    
+
     - name: Discover testcases
       id: discover
       run: |
         # Find all testcase folders (excluding common folders like README, etc.)
         testcase_dirs=$(find testcases -maxdepth 1 -type d -name "*-*" | sed 's|testcases/||' | sort)
-        
+
         echo "Found testcase directories:"
         echo "$testcase_dirs"
-        
+
         # Convert to JSON array for matrix
         testcases_json=$(echo "$testcase_dirs" | jq -R -s -c 'split("\n")[:-1]')
         echo "testcases=$testcases_json" >> $GITHUB_OUTPUT
@@ -36,46 +36,39 @@ jobs:
   integration-tests:
     needs: [discover-testcases]
     runs-on: ubuntu-latest
+    container:
+      image: ghcr.io/astral-sh/uv:python3.12-bookworm
+      env:
+        UIPATH_JOB_KEY: "3a03d5cb-fa21-4021-894d-a8e2eda0afe0"
     strategy:
       fail-fast: false
       matrix:
         testcase: ${{ fromJson(needs.discover-testcases.outputs.testcases) }}
-        environment: [alpha, cloud]
+        environment: [alpha, staging] # temporary disable [cloud]
         use_azure_chat: [true, false]
-    
+
     name: "${{ matrix.testcase }} / ${{ matrix.environment }} / ${{ matrix.use_azure_chat && 'UiPathAzureChatOpenAI' || 'UiPathChat' }}"
-    
+
     steps:
     - name: Checkout code
       uses: actions/checkout@v4
 
-    - name: Set up Docker Buildx
-      uses: docker/setup-buildx-action@v3
-
-    - name: Build Docker image
-      run: |
-        echo "Building Docker image for ${{ matrix.testcase }} at $(date)"
-        docker build -f testcases/Dockerfile \
-          -t uipath-langchain-testbase:latest \
-          .
-        echo "Docker image built at $(date)"
+    - name: Install Dependencies
+      run: uv sync
 
     - name: Run testcase
       env:
-        CLIENT_ID:      ${{ matrix.environment == 'alpha' && secrets.ALPHA_TEST_CLIENT_ID || secrets.CLOUD_TEST_CLIENT_ID }}
-        CLIENT_SECRET:  ${{ matrix.environment == 'alpha' && secrets.ALPHA_TEST_CLIENT_SECRET || secrets.CLOUD_TEST_CLIENT_SECRET }}
-        BASE_URL:       ${{ matrix.environment == 'alpha' && secrets.ALPHA_BASE_URL || secrets.CLOUD_BASE_URL }}
+        CLIENT_ID:      ${{ matrix.environment == 'alpha' && secrets.ALPHA_TEST_CLIENT_ID || matrix.environment == 'staging' && secrets.STAGING_TEST_CLIENT_ID || matrix.environment == 'cloud' && secrets.CLOUD_TEST_CLIENT_ID }}
+        CLIENT_SECRET:  ${{ matrix.environment == 'alpha' && secrets.ALPHA_TEST_CLIENT_SECRET || matrix.environment == 'staging' && secrets.STAGING_TEST_CLIENT_SECRET || matrix.environment == 'cloud' && secrets.CLOUD_TEST_CLIENT_SECRET }}
+        BASE_URL:       ${{ matrix.environment == 'alpha' && secrets.ALPHA_BASE_URL || matrix.environment == 'staging' && secrets.STAGING_BASE_URL || matrix.environment == 'cloud' && secrets.CLOUD_BASE_URL }}
         USE_AZURE_CHAT: ${{ matrix.use_azure_chat }}
+      working-directory: testcases/${{ matrix.testcase }}
       run: |
         echo "Running testcase: ${{ matrix.testcase }}"
         echo "Environment: ${{ matrix.environment }}"
         echo "LLM: ${{ matrix.use_azure_chat && 'UiPathAzureChatOpenAI' || 'UiPathChat' }}"
         echo "USE_AZURE_CHAT: ${{ matrix.use_azure_chat }}"
-        
-        docker run --rm \
-          -e CLIENT_ID="$CLIENT_ID" \
-          -e CLIENT_SECRET="$CLIENT_SECRET" \
-          -e BASE_URL="$BASE_URL" \
-          -e USE_AZURE_CHAT="$USE_AZURE_CHAT" \
-          uipath-langchain-testbase:latest \
-          bash /app/testcases/${{ matrix.testcase }}/run.sh
+
+        # Execute the testcase run script directly
+        bash run.sh
+        bash ../common/validate_output.sh

{uipath_langchain-0.0.139 → uipath_langchain-0.0.141}/.github/workflows/publish-dev.yml

@@ -7,7 +7,6 @@ on:
       PYPI_TOKEN_NIGHTLY:
         required: true
 
-
 jobs:
   publish-dev:
     runs-on: ubuntu-latest
@@ -34,44 +33,43 @@ jobs:
 
       - name: Modify pyproject.toml for custom UiPath version
         if: contains(github.event.pull_request.labels.*.name, 'test-core-dev-version')
-        shell: bash
+        shell: pwsh
+        env:
+          PR_TITLE: ${{ github.event.pull_request.title }}
         run: |
-          # Backup original pyproject.toml
-          cp pyproject.toml pyproject.toml.backup
-
-          # Extract custom version from PR title
-          PR_TITLE="${{ github.event.pull_request.title }}"
-          VERSION=$(echo "$PR_TITLE" | grep -oE '[0-9]+\.[0-9]+\.[0-9]+\.dev[0-9]+' | head -1)
-
-          if [ -z "$VERSION" ]; then
-            echo "No version found in PR title. Please include version like: 2.0.65.dev1004030443"
+          # Extract version from PR title (e.g., "2.0.65.dev1004030443")
+          if ($env:PR_TITLE -match '(\d+\.\d+\.\d+\.dev\d+)') {
+            $VERSION = $matches[1]
+          } else {
+            Write-Error "No version found in PR title. Example: 'chore: test (uipath version 2.0.65.dev1004030443)'"
             exit 1
-          fi
+          }
 
-          echo "Extracted version: $VERSION"
+          Write-Output "Using UiPath version: $VERSION"
 
-                      # Update the uipath dependency to the custom version (match both == and >= patterns)
-            # Target only the dependency lines in dependencies arrays, not project name
-            sed -i '/dependencies = \[/,/\]/ s|"uipath[=><^~!]*[^"]*"|"uipath=='$VERSION'"|' pyproject.toml
-            sed -i '/\[project\.optional-dependencies\]/,/^\[/ s|"uipath[=><^~!]*[^"]*"|"uipath=='$VERSION'"|' pyproject.toml
+          # Update uipath dependency to exact version (only in dependency arrays, not project name)
+          $content = Get-Content pyproject.toml -Raw
 
+          # Replace in main dependencies array
+          $content = $content -replace '(?s)(dependencies\s*=\s*\[.*?\])', {
+            param($match)
+            $match.Value -replace '"uipath([>=<\s,][^"]*|)"', "`"uipath==$VERSION`""
+          }
 
+          # Replace in optional-dependencies section (from [project.optional-dependencies] to next [)
+          $content = $content -replace '(?s)(\[project\.optional-dependencies\].*?)(?=\n\[|\z)', {
+            param($match)
+            $match.Value -replace '"uipath([>=<\s,][^"]*|)"', "`"uipath==$VERSION`""
+          }
 
-          # Add or update [tool.uv.sources] section if it doesn't exist
-          if ! grep -q "\[tool\.uv\.sources\]" pyproject.toml; then
-            echo "" >> pyproject.toml
-            echo "[tool.uv.sources]" >> pyproject.toml
-            echo 'uipath = { index = "testpypi" }' >> pyproject.toml
-          else
-            # Update existing sources if needed
-            if ! grep -q 'uipath = { index = "testpypi" }' pyproject.toml; then
-              sed -i '/\[tool\.uv\.sources\]/a uipath = { index = "testpypi" }' pyproject.toml
-            fi
-          fi
+          # Add [tool.uv.sources] if missing
+          if ($content -notmatch '\[tool\.uv\.sources\]') {
+            $content += "`n`n[tool.uv.sources]`n uipath = { index = `"testpypi`" }`n"
+          }
 
-          echo "Modified pyproject.toml to use UiPath version $VERSION from testpypi"
-          echo "=== Modified pyproject.toml content ==="
-          grep -A5 -B5 "uipath\|testpypi" pyproject.toml || true
+          # Save changes
+          $content | Set-Content pyproject.toml -NoNewline
+          Write-Output "✓ Updated pyproject.toml"
 
       - name: Install dependencies
         run: uv sync --all-extras

{uipath_langchain-0.0.139 → uipath_langchain-0.0.141}/.gitignore

@@ -165,7 +165,7 @@ cython_debug/
 #  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/
+.idea/
 
 # Ruff stuff:
 .ruff_cache/
@@ -178,4 +178,4 @@ cython_debug/
 **/.uipath
 **/**.nupkg
 **/__uipath/
-**/.langgraph_api
+**/.langgraph_api

{uipath_langchain-0.0.139 → uipath_langchain-0.0.141}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: uipath-langchain
-Version: 0.0.139
+Version: 0.0.141
 Summary: UiPath Langchain
 Project-URL: Homepage, https://uipath.com
 Project-URL: Repository, https://github.com/UiPath/uipath-langchain-python
@@ -26,7 +26,7 @@ Requires-Dist: openai>=1.65.5
 Requires-Dist: openinference-instrumentation-langchain>=0.1.50
 Requires-Dist: pydantic-settings>=2.6.0
 Requires-Dist: python-dotenv>=1.0.1
-Requires-Dist: uipath<2.2.0,>=2.1.76
+Requires-Dist: uipath<2.2.0,>=2.1.96
 Provides-Extra: langchain
 Description-Content-Type: text/markdown
 

{uipath_langchain-0.0.139 → uipath_langchain-0.0.141}/pyproject.toml

@@ -1,11 +1,11 @@
 [project]
 name = "uipath-langchain"
-version = "0.0.139"
+version = "0.0.141"
 description = "UiPath Langchain"
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.10"
 dependencies = [
-    "uipath>=2.1.76, <2.2.0",
+    "uipath>=2.1.96, <2.2.0",
     "langgraph>=0.5.0, <0.7.0",
     "langchain-core>=0.3.34",
     "langgraph-checkpoint-sqlite>=2.0.3",

{uipath_langchain-0.0.139 → uipath_langchain-0.0.141}/samples/README.md

@@ -18,5 +18,8 @@ This sample shows how to create an agent using LangGraph with multiple tool serv
 ## [Simple remote MCP](simple-remote-mcp)
 This sample demonstrates the creation of an agent using LangGraph, which connects to a remote MCP (Model Context Protocol) Server.
 
+## [OAuth external apps agent](oauth-external-apps-agent)
+This sample shows how to build a LangGraph agent that connects to a remote UiPath MCP server using OAuth authentication through an external UiPath application for dynamic access token management.
+
 ## [Ticket classification](ticket-classification)
 This sample demonstrates automatic classification of support tickets into categories. It includes a human approval step via UiPath Action Center.

uipath_langchain-0.0.141/samples/oauth-external-apps-agent/README.md

@@ -0,0 +1,84 @@
+# LangGraph Agent with OAuth and MCP Servers
+
+This project demonstrates how to build a LangGraph agent that connects to a remote UiPath MCP server, using an external UiPath application to handle OAuth authentication.
+
+## Overview
+
+The agent uses:
+- UiPathChat with Claude 3.5 Sonnet as the language model
+- LangGraph for orchestration
+- Remote tool execution via UiPath MCP server
+- Dynamic access token refresh through client credentials grant (OAuth)
+
+## Architecture
+
+```mermaid
+---
+config:
+  flowchart:
+    curve: linear
+---
+graph TD;
+	__start__([<p>__start__</p>]):::first
+	fetch_new_access_token(fetch_new_access_token)
+	connect_to_mcp(connect_to_mcp)
+	__end__([<p>__end__</p>]):::last
+	__start__ -.-> connect_to_mcp;
+	__start__ -.-> fetch_new_access_token;
+	fetch_new_access_token --> connect_to_mcp;
+	connect_to_mcp --> __end__;
+	classDef default fill:#f2f0ff,line-height:1.2
+	classDef first fill-opacity:0
+	classDef last fill:#bfb6fc
+```
+
+The workflow follows a ReAct pattern:
+1. Query is sent to the agent
+2. The agent first attempts to connect to the remote MCP server using the current `UIPATH_ACCESS_TOKEN`.
+3. If the token is missing or expired, the workflow triggers a call to the UiPath external application endpoint to fetch a fresh token and stores it in the environment.
+4. Once connected, the MCP tools are loaded into the ReAct agent.
+5. The agent receives both system context and the human task, deciding whether to invoke tools or provide a direct answer.
+6. The process repeats until the agent has enough information to produce a final response.
+7. The response is collected and returned as the workflow output.
+
+## Prerequisites
+
+- Python 3.10+
+- `uipath-langchain`
+- `langchain-mcp-adapters`
+- `langgraph`
+- `httpx`
+- `python-dotenv`
+- UiPath OAuth credentials and MCP server URL in environment
+- UiPath external application configured with `OR.Jobs` scope (or appropriate scope for your MCP server)
+
+## Installation
+
+```bash
+uv venv -p 3.11 .venv
+.venv\Scripts\activate
+uv sync
+```
+
+Set your MCP Remote Server URL and client secret as environment variables in .env
+
+```bash
+UIPATH_CLIENT_SECRET=your_client_secret
+UIPATH_MCP_SERVER_URL=https://your-uipath-instance/account/tenant/mcp_/mcp/server_slug
+```
+
+Configure the following constants in `main.py`:
+- `UIPATH_CLIENT_ID` - Your external application client ID
+- `UIPATH_URL` - Your UiPath instance base URL
+- `UIPATH_SCOPE` - OAuth scope (default: `OR.Jobs`)
+
+## Debugging
+
+For debugging issues:
+
+1. Check logs for any connection or runtime errors:
+   ```bash
+   uipath run agent --debug '{"task": "What is 2 + 2?"}'
+   ```
+
+

uipath_langchain-0.0.141/samples/oauth-external-apps-agent/input.json

@@ -0,0 +1 @@
+{ "task": "What is 2+2" }

uipath_langchain-0.0.141/samples/oauth-external-apps-agent/langgraph.json

@@ -0,0 +1,7 @@
+{
+    "dependencies": ["."],
+    "graphs": {
+        "agent": "./main.py:graph"
+    },
+    "env": ".env"
+  }

uipath_langchain-0.0.141/samples/oauth-external-apps-agent/main.py

@@ -0,0 +1,95 @@
+import os
+import dotenv
+import httpx
+from contextlib import asynccontextmanager
+from typing import Optional, Literal
+
+from pydantic import BaseModel
+from langgraph.graph import StateGraph, START, END
+from langgraph.types import Command
+from langgraph.prebuilt import create_react_agent
+from langchain.schema import SystemMessage, HumanMessage
+
+from uipath_langchain.chat.models import UiPathChat
+from langchain_mcp_adapters.tools import load_mcp_tools
+from mcp import ClientSession
+from mcp.client.streamable_http import streamablehttp_client
+from uipath import UiPath
+
+dotenv.load_dotenv()
+
+UIPATH_CLIENT_ID = "EXTERNAL_APP_CLIENT_ID_HERE"
+UIPATH_CLIENT_SECRET = os.getenv("UIPATH_CLIENT_SECRET")
+UIPATH_SCOPE = "OR.Jobs"
+UIPATH_URL = "base_url"
+UIPATH_MCP_SERVER_URL = os.getenv("UIPATH_MCP_SERVER_URL")
+
+class GraphInput(BaseModel):
+    task: str
+
+class GraphOutput(BaseModel):
+    result: str
+
+class State(BaseModel):
+    task: str
+    access_token: Optional[str] = os.getenv("UIPATH_ACCESS_TOKEN")
+    result: Optional[str] = None
+
+async def fetch_new_access_token(state: State) -> Command:
+    try:
+        UiPath(
+            base_url=UIPATH_URL,
+            client_id=UIPATH_CLIENT_ID,
+            client_secret=UIPATH_CLIENT_SECRET,
+            scope=UIPATH_SCOPE,
+        )
+        return Command(update={"access_token": os.getenv("UIPATH_ACCESS_TOKEN")})
+
+    except Exception as e:
+        raise Exception(f"Failed to initialize UiPath SDK: {str(e)}")
+
+@asynccontextmanager
+async def agent_mcp(access_token: str):
+    async with streamablehttp_client(
+        url=UIPATH_MCP_SERVER_URL,
+        headers={"Authorization": f"Bearer {access_token}"},
+        timeout=60,
+    ) as (read, write, _):
+        async with ClientSession(read, write) as session:
+            await session.initialize()
+            tools = await load_mcp_tools(session)
+            model = UiPathChat(model="anthropic.claude-3-5-sonnet-20240620-v1:0")
+            agent = create_react_agent(model, tools=tools)
+            yield agent
+
+async def connect_to_mcp(state: State) -> Command:
+    try:
+        async with agent_mcp(state.access_token) as agent:
+            agent_response = await agent.ainvoke({
+                "messages": [
+                    SystemMessage(content="You are a helpful assistant."),
+                    HumanMessage(content=state.task),
+                ],
+            })
+            return Command(update={"result": agent_response["messages"][-1].content})
+    except ExceptionGroup as e:
+        for error in e.exceptions:
+            if isinstance(error, httpx.HTTPStatusError) and error.response.status_code == 401:
+                return Command(update={"access_token": None})
+        raise
+
+def route_start(state: State) -> Literal["fetch_new_access_token", "connect_to_mcp"]:
+    return "fetch_new_access_token" if state.access_token is None else "connect_to_mcp"
+
+def route_after_connect(state: State):
+    return "fetch_new_access_token" if state.access_token is None else END
+
+builder = StateGraph(State, input=GraphInput, output=GraphOutput)
+builder.add_node("fetch_new_access_token", fetch_new_access_token)
+builder.add_node("connect_to_mcp", connect_to_mcp)
+
+builder.add_conditional_edges(START, route_start)
+builder.add_edge("fetch_new_access_token", "connect_to_mcp")
+builder.add_conditional_edges("connect_to_mcp", route_after_connect)
+
+graph = builder.compile()

uipath_langchain-0.0.141/samples/oauth-external-apps-agent/pyproject.toml

@@ -0,0 +1,17 @@
+[project]
+name = "oauth-external-apps-agent"
+version = "0.0.7"
+description = "Agent that connects to an MCP server implementing OAuth using an external application."
+authors = [{ name = "John Doe", email = "john.doe@myemail.com" }]
+dependencies = [
+    "uipath-langchain>=0.0.140",
+    "langchain>=0.3.26",
+    "langchain-anthropic>=0.3.17",
+    "langgraph>=0.5.3",
+    "python-dotenv>=1.0.0",
+    "anthropic>=0.57.1",
+    "langchain-mcp-adapters>=0.1.9",
+    "mypy>=1.17.1",
+    "uipath>=2.1.38",
+]
+requires-python = ">=3.10"