uipath-langchain 0.0.88__tar.gz → 0.0.89__tar.gz

uipath_langchain-0.0.89/.github/workflows/commitlint.yml

@@ -0,0 +1,28 @@
+name: Commit Lint
+
+on:
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  commit-lint:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+        with:
+          fetch-depth: 0
+
+      - name: Lint commits
+        uses: wagoid/commitlint-github-action@v3
+
+      - name: Block fixup commits
+        if: ${{ github.event_name != 'merge_group' }}
+        uses: 13rac1/block-fixup-merge-action@v2.0.0
+
+      - name: Block Merge Commits
+        if: ${{ github.event_name != 'merge_group' }}
+        uses: Morishiri/block-merge-commits-action@v1.0.1
+        with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}

{uipath_langchain-0.0.88 → uipath_langchain-0.0.89}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: uipath-langchain
-Version: 0.0.88
+Version: 0.0.89
 Summary: UiPath Langchain
 Project-URL: Homepage, https://uipath.com
 Project-URL: Repository, https://github.com/UiPath/uipath-langchain-python
@@ -25,7 +25,7 @@ Requires-Dist: pydantic-settings>=2.6.0
 Requires-Dist: python-dotenv>=1.0.1
 Requires-Dist: requests>=2.23.3
 Requires-Dist: types-requests>=2.32.0.20241016
-Requires-Dist: uipath<2.1.0,>=2.0.4
+Requires-Dist: uipath<2.1.0,>=2.0.7
 Provides-Extra: langchain
 Description-Content-Type: text/markdown
 

{uipath_langchain-0.0.88 → uipath_langchain-0.0.89}/docs/interrupt_models.md

@@ -9,7 +9,9 @@ UiPath platform and the Langchain coded agents.
 
 ### 1. InvokeProcess
 
-The `InvokeProcess` model is utilized to invoke a process within UiPath cloud platform. Upon completion of the invoked process, the current agent will automatically resume execution.
+The `InvokeProcess` model is utilized to invoke a process within the UiPath cloud platform.
+This process can be of various types, including API workflows, Agents or RPA automation.
+Upon completion of the invoked process, the current agent will automatically resume execution.
 
 #### Attributes:
 - **name** (str): The name of the process to invoke.
@@ -20,6 +22,8 @@ The `InvokeProcess` model is utilized to invoke a process within UiPath cloud pl
 process_output = interrupt(InvokeProcess(name="MyProcess", input_arguments={"arg1": "value1"}))
 ```
 
+For a practical implementation of the `InvokeProcess` model, refer to the sample usage in the [planner.py](../../samples/multi-agent-planner-researcher-coder-distributed/src/multi-agent-distributed/planner.py#L184) file. This example demonstrates how to invoke a process with dynamic input arguments, showcasing the integration of the interrupt functionality within a multi-agent system or a system where an agent integrates with RPA processes and API workflows.
+
 ---
 
 ### 2. WaitJob

{uipath_langchain-0.0.88 → uipath_langchain-0.0.89}/pyproject.toml

@@ -1,11 +1,11 @@
 [project]
 name = "uipath-langchain"
-version = "0.0.88"
+version = "0.0.89"
 description = "UiPath Langchain"
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.10"
 dependencies = [
-    "uipath>=2.0.4, <2.1.0",
+    "uipath>=2.0.7, <2.1.0",
     "langgraph>=0.2.70",
     "langchain-core>=0.3.34",
     "langgraph-checkpoint-sqlite>=2.0.3",

{uipath_langchain-0.0.88 → uipath_langchain-0.0.89}/samples/company-research-agent/pyproject.toml

@@ -11,7 +11,7 @@ dependencies = [
     "langchain-community>=0.3.9",
     "langchain-anthropic>=0.3.8",
     "tavily-python>=0.5.0",
-    "uipath-langchain==0.0.87"
+    "uipath-langchain==0.0.88"
 ]
 
 [project.optional-dependencies]

{uipath_langchain-0.0.88 → uipath_langchain-0.0.89}/samples/company-research-agent/uv.lock

@@ -355,7 +355,7 @@ requires-dist = [
     { name = "mypy", marker = "extra == 'dev'", specifier = ">=1.11.1" },
     { name = "ruff", marker = "extra == 'dev'", specifier = ">=0.6.1" },
     { name = "tavily-python", specifier = ">=0.5.0" },
-    { name = "uipath-langchain", specifier = "==0.0.87" },
+    { name = "uipath-langchain", specifier = "==0.0.88" },
 ]
 provides-extras = ["dev"]
 
@@ -1815,7 +1815,7 @@ wheels = [
 
 [[package]]
 name = "uipath"
-version = "2.0.1"
+version = "2.0.4"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "click" },
@@ -1828,14 +1828,14 @@ dependencies = [
     { name = "tomli" },
     { name = "types-requests" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/1b/74/3d0e8c9c133492af75cc47d64b76e9ef9b108b4d709ea98e039aec0ff289/uipath-2.0.1.tar.gz", hash = "sha256:869637a976cca6058c4ee0b2ed79a85d4a9eb19a3306bee5e24a6dd49979c550", size = 206254 }
+sdist = { url = "https://files.pythonhosted.org/packages/6c/0d/4ae746ca61ec42ca6ab449692bacfbb34e013a97224e6f175715b448ab9b/uipath-2.0.4.tar.gz", hash = "sha256:9ac7abbc2e1f53207e11cb1235e99efc6cf7c265595e0f1ac981512a443e70bc", size = 207150 }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/80/a6/c45c040b5a2ab86da0e4312b20208a5df68100d04be7f2e69c17f18ccc04/uipath-2.0.1-py3-none-any.whl", hash = "sha256:992a34bef5aef8c9a98fa188d1cff165e8271b9de93e25d3ed0b18d0f16c65c4", size = 84375 },
+    { url = "https://files.pythonhosted.org/packages/0f/d9/e4c2d3ba7d87e59937ca5980f4bc2b7d06c68578df33a9a0d4eb99764d44/uipath-2.0.4-py3-none-any.whl", hash = "sha256:698680eb2f8fd885dbc9e13856028cdd10cfac525698375022ff484629f3f778", size = 85424 },
 ]
 
 [[package]]
 name = "uipath-langchain"
-version = "0.0.87"
+version = "0.0.88"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "httpx" },
@@ -1852,9 +1852,9 @@ dependencies = [
     { name = "types-requests" },
     { name = "uipath" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/4a/f0/f9ac644bcb818efd2b1e35e50eeb8d20980177aabf1d359dda4e5a6c77a5/uipath_langchain-0.0.87.tar.gz", hash = "sha256:07f61284e0c734fddb7dfbdc020e16d439a319adb306a453fa8d55aebcc78cab", size = 1309008 }
+sdist = { url = "https://files.pythonhosted.org/packages/80/0e/e05ecfc5a5b6b7f277dca18e61724c1a923ae4c9af39f71f2c8dce52343d/uipath_langchain-0.0.88.tar.gz", hash = "sha256:f06cc80c9499ae4309275119a9abf5d74c881aaef6731c6efb5b525a1291ef33", size = 1188502 }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/98/1a/4e34819ac42413b8a4650dcb05c698da7114909584c0205d66b4fe4a4424/uipath_langchain-0.0.87-py3-none-any.whl", hash = "sha256:92dd352c985ed580a9a93bcede2232205c9700bcec7ec62b1835ae372d184084", size = 50642 },
+    { url = "https://files.pythonhosted.org/packages/3a/7a/68ec6fcb4698af7f27c30a2107c349fb6115b84373dba38413346e8c5a57/uipath_langchain-0.0.88-py3-none-any.whl", hash = "sha256:78c92bebbd4a3651adcf914d3563a551222bef86f54cb3eb270d93a39ede7d28", size = 50641 },
 ]
 
 [[package]]

{uipath_langchain-0.0.88 → uipath_langchain-0.0.89}/samples/hitl-inbox-server/pyproject.toml

@@ -11,6 +11,6 @@ dependencies = [
     "jinja2>=3.1.6",
     "httpx>=0.28.1",
     "python-multipart>=0.0.20",
-    "uipath==2.0.1"
+    "uipath==2.0.4"
 ]
 requires-python = ">=3.10"

{uipath_langchain-0.0.88 → uipath_langchain-0.0.89}/samples/hitl-inbox-server/uv.lock

@@ -235,7 +235,7 @@ requires-dist = [
     { name = "jinja2", specifier = ">=3.1.6" },
     { name = "python-multipart", specifier = ">=0.0.20" },
     { name = "sqlalchemy", specifier = ">=2.0.38" },
-    { name = "uipath", specifier = "==2.0.1" },
+    { name = "uipath", specifier = "==2.0.4" },
     { name = "uvicorn", specifier = ">=0.34.0" },
 ]
 
@@ -686,7 +686,7 @@ wheels = [
 
 [[package]]
 name = "uipath"
-version = "2.0.1"
+version = "2.0.4"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "click" },
@@ -699,9 +699,9 @@ dependencies = [
     { name = "tomli" },
     { name = "types-requests" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/1b/74/3d0e8c9c133492af75cc47d64b76e9ef9b108b4d709ea98e039aec0ff289/uipath-2.0.1.tar.gz", hash = "sha256:869637a976cca6058c4ee0b2ed79a85d4a9eb19a3306bee5e24a6dd49979c550", size = 206254 }
+sdist = { url = "https://files.pythonhosted.org/packages/6c/0d/4ae746ca61ec42ca6ab449692bacfbb34e013a97224e6f175715b448ab9b/uipath-2.0.4.tar.gz", hash = "sha256:9ac7abbc2e1f53207e11cb1235e99efc6cf7c265595e0f1ac981512a443e70bc", size = 207150 }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/80/a6/c45c040b5a2ab86da0e4312b20208a5df68100d04be7f2e69c17f18ccc04/uipath-2.0.1-py3-none-any.whl", hash = "sha256:992a34bef5aef8c9a98fa188d1cff165e8271b9de93e25d3ed0b18d0f16c65c4", size = 84375 },
+    { url = "https://files.pythonhosted.org/packages/0f/d9/e4c2d3ba7d87e59937ca5980f4bc2b7d06c68578df33a9a0d4eb99764d44/uipath-2.0.4-py3-none-any.whl", hash = "sha256:698680eb2f8fd885dbc9e13856028cdd10cfac525698375022ff484629f3f778", size = 85424 },
 ]
 
 [[package]]

uipath_langchain-0.0.89/samples/multi-agent-planner-researcher-coder-distributed/README.md

@@ -0,0 +1,251 @@
+# Multi-Agent Task Execution System
+
+This repository implements a multi-agent system that decomposes complex tasks into discrete steps, routing them to specialized agents for execution. The system comprises three main components:
+
+1. **Planner Agent**: Orchestrates the workflow by planning task execution and routing subtasks to worker agents.
+2. **Researcher Agent**: Gathers information, formulas, and reference materials without performing calculations.
+3. **Coder Agent**: Executes calculations and evaluates formulas with specific values.
+
+Each agent operates as an independent entry point and can be deployed as a separate process, while still being packaged together as part of an Orchestrator Agent Package.
+
+## System Architecture
+
+The system utilizes LangGraph to create a directed graph of agents that can communicate and share state.
+
+### Planner Agent Graph
+```mermaid
+---
+config:
+  flowchart:
+    curve: linear
+---
+graph TD;
+	__start__(<p>__start__</p>)
+	input(input)
+	create_plan(create_plan)
+	supervisor([supervisor]):::last
+	invoke_agent(invoke_agent)
+	__start__ --> input;
+	create_plan --> supervisor;
+	input --> supervisor;
+	invoke_agent --> supervisor;
+	classDef default fill:#f2f0ff,line-height:1.2
+	classDef first fill-opacity:0
+	classDef last fill:#bfb6fc
+```
+
+### Researcher Agent Graph
+```mermaid
+---
+config:
+  flowchart:
+    curve: linear
+---
+graph TD;
+	__start__([<p>__start__</p>]):::first
+	__end__([<p>__end__</p>]):::last
+	__start__ --> researcher___start__;
+	researcher___end__ --> __end__;
+	subgraph researcher
+	researcher___start__(<p>__start__</p>)
+	researcher_agent(agent)
+	researcher_tools(tools)
+	researcher___end__(<p>__end__</p>)
+	researcher___start__ --> researcher_agent;
+	researcher_tools --> researcher_agent;
+	researcher_agent -.-> researcher_tools;
+	researcher_agent -.-> researcher___end__;
+	end
+	classDef default fill:#f2f0ff,line-height:1.2
+	classDef first fill-opacity:0
+	classDef last fill:#bfb6fc
+```
+
+### Coder Agent Graph
+```mermaid
+---
+config:
+  flowchart:
+    curve: linear
+---
+graph TD;
+	__start__([<p>__start__</p>]):::first
+	__end__([<p>__end__</p>]):::last
+	__start__ --> coder___start__;
+	coder___end__ --> __end__;
+	subgraph coder
+	coder___start__(<p>__start__</p>)
+	coder_agent(agent)
+	coder_tools(tools)
+	coder___end__(<p>__end__</p>)
+	coder___start__ --> coder_agent;
+	coder_tools --> coder_agent;
+	coder_agent -.-> coder_tools;
+	coder_agent -.-> coder___end__;
+	end
+	classDef default fill:#f2f0ff,line-height:1.2
+	classDef first fill-opacity:0
+	classDef last fill:#bfb6fc
+```
+
+## Agent Responsibilities
+
+- **Planner Agent**:
+  - Takes user questions and formulates execution plans.
+  - Routes tasks to appropriate worker agents.
+  - Manages execution flow and state tracking.
+  - Returns final results to the user.
+
+- **Researcher Agent**:
+  - Retrieves information using a Tavily search tool.
+  - Provides factual content, definitions, and formulas.
+  - Does not perform calculations (strictly enforced).
+
+- **Coder Agent**:
+  - Executes calculations using Python code.
+  - Evaluates formulas with specific input values.
+  - Returns precise numerical results.
+
+## Usage
+
+### Running the System
+
+To run the entire system, use the following command with the complete JSON input:
+
+```bash
+uipath run planner '{"question": "First, please state the Pythagorean theorem. Give only the formula, using variables a, b, and c. Then apply this formula to calculate the value when a=2 and b=3."}'
+```
+
+### Debugging Individual Agents
+
+You can debug individual agents by invoking them directly:
+
+#### Researcher Agent
+Run the researcher agent with:
+
+```bash
+uipath run researcher '{"messages":[{"content":"State the Pythagorean theorem formula using variables a, b, and c","type":"human"}]}'
+```
+
+#### Coder Agent
+Run the coder agent with:
+
+```bash
+uipath run coder '{"messages":[{"content":"Let me help you state the Pythagorean theorem formula. The Pythagorean theorem is a fundamental mathematical formula that describes the relationship between the sides of a right triangle.\n\nThe formula is:\n\na² + b² = c²\n\nWhere:\n- a and b are the lengths of the two legs (the sides adjacent to the right angle)\n- c is the length of the hypotenuse (the longest side, opposite to the right angle).","type":"human","name":"researcher-agent"},{"content":"Calculate the result using the formula when a=2 and b=3","type":"human"}]}'
+```
+
+## Sample Workflow
+
+1. User submits a question about the Pythagorean theorem.
+2. Planner creates an execution plan with two steps:
+   - Step 1: Researcher agent retrieves the Pythagorean theorem formula.
+   - Step 2: Coder agent applies the formula to calculate the result for a=2, b=3.
+3. Planner executes Step 1 by invoking the researcher agent.
+4. Researcher agent returns the formula a² + b² = c².
+5. Planner executes Step 2 by invoking the coder agent.
+6. Coder agent calculates c = √(2² + 3²) = √(4 + 9) = √13 ≈ 3.606.
+7. Planner combines the responses and returns the final answer to the user.
+
+## Steps to Execute Project on UiPath Cloud Platform
+
+1. **Clone the Repository**
+   ```bash
+   git clone https://github.com/UiPath/uipath-langchain-python.git
+   ```
+
+2. **Navigate to the Sample Directory**
+   - **Windows:**
+     ```bash
+     cd .\uipath-langchain-python\samples\multi-agent-planner-researcher-coder-distributed
+     ```
+
+   - **Unix-like Systems (Linux, macOS):**
+     ```bash
+     cd ./uipath-langchain-python/samples/multi-agent-planner-researcher-coder-distributed
+     ```
+
+3. **Create and Activate a Virtual Python Environment**
+   ```bash
+   pip install uv
+   uv venv -p 3.11 .venv
+   .venv\Scripts\activate  # Windows
+   source .venv/bin/activate  # Unix-like Systems
+   uv sync
+   ```
+
+4. **Authenticate with UiPath Cloud Platform**
+   ```bash
+   uipath auth
+   ```
+   > **Note:** After successful authentication in the browser, select the tenant for publishing the agent package.
+   ```
+   Received log data
+   Received authentication information
+   Available tenants:
+     0: cosmin
+     1: DefaultTenant
+     2: Demo
+     3: lucian
+     4: Solutions
+     5: SolutionsTest
+     6: Test
+     7: TestRoles
+   Select tenant: 2
+   ```
+
+5. **Package and Publish Agents**
+   ```bash
+   uipath pack
+   uipath publish
+   ```
+   > **Note:** You will need to select the feed for publishing:
+   ```
+   Select feed type:
+     0: Tenant package feed
+     1: Personal workspace
+   Select feed: 0
+   ```
+
+6. **Create Agent Processes in Orchestrator**
+   - **Planner Agent**
+     ![planner-agent-package-overview](../../docs/sample_images/planner-agent-package-overview.png)
+     ![planner-agent-process-configuration](../../docs/sample_images/planner-agent-process-configuration.png)
+
+   - **Researcher Agent**
+     ![researcher-agent-package-overview](../../docs/sample_images/researcher-agent-package-overview.png)
+     ![researcher-agent-process-configuration](../../docs/sample_images/researcher-agent-process-configuration.png)
+
+   - **Coder Agent**
+     ![coder-agent-package-overview](../../docs/sample_images/coder-agent-package-overview.png)
+     ![coder-agent-process-configuration](../../docs/sample_images/coder-agent-process-configuration.png)
+
+   > **Note:** Ensure that the display names for the coder and researcher agent processes are *coder-agent* and *researcher-agent*,
+        and that all 3 agents are placed in the same folder.
+
+7. **Run the Planner Agent with Any Input Question**
+   > **Tip:** For a five-step action plan, consider using the following input:
+   ```
+   Could you find a Python solution for the N-Queens puzzle for N=8? Please analyze why this solution works,
+   considering the key programming concepts it employs.
+   Then, revise the solution to handle a dynamic value of N, where N is any positive integer.
+   After that, research the time and space complexity of this new solution.
+   Lastly, demonstrate this revised Python solution with N=10.
+   ```
+
+## Implementation Details
+
+The system is implemented using:
+
+- LangGraph for agent orchestration
+- LangChain for agent creation and tool integration
+- Claude 3.5 Sonnet for LLM capabilities
+- Tavily for search functionality in the researcher agent
+- Python REPL for code execution in the coder agent
+
+## Requirements
+
+- Python 3.10+
+- LangGraph
+- LangChain
+- Anthropic API key
+- Tavily API key

{uipath_langchain-0.0.88 → uipath_langchain-0.0.89}/samples/multi-agent-planner-researcher-coder-distributed/pyproject.toml

@@ -3,7 +3,7 @@ name = "multi-agents-distributed"
 version = "0.0.1"
 description = "Supervisor agent that coordinates between a researcher and a coder"
 authors = [
-    { name = "Radu Mocanu" }
+    { name = "Radu Mocanu", email = "radu.mocanu@uipath.com" }
 ]
 requires-python = ">=3.10"
 dependencies = [
@@ -12,7 +12,7 @@ dependencies = [
     "langchain-anthropic>=0.3.8",
     "langchain-experimental>=0.3.4",
     "tavily-python>=0.5.0",
-    "uipath-langchain==0.0.87"
+    "uipath-langchain==0.0.88"
 ]
 
 [project.optional-dependencies]

{uipath_langchain-0.0.88 → uipath_langchain-0.0.89}/samples/multi-agent-planner-researcher-coder-distributed/src/multi-agent-distributed/planner.py

@@ -8,7 +8,7 @@ from langgraph.graph import START, MessagesState, StateGraph
 from langgraph.types import Command, interrupt
 from pydantic import BaseModel, Field
 from typing_extensions import TypedDict
-from uipath._models import InvokeProcess
+from uipath.models import InvokeProcess
 
 worker_agents = {"researcher": "researcher-agent", "coder": "coder-agent"}
 agent_names = list(worker_agents.values())