feat: uipath-python-integrations

Author: cosmyo

.github/workflows/integration_tests.yml

@@ -24,7 +24,7 @@ jobs:
       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)
+        testcase_dirs=$(find packages/uipath-llamaindex/testcases -maxdepth 1 -type d -name "*-*" | sed 's|packages/uipath-llamaindex/testcases/||' | sort)
 
         echo "Found testcase directories:"
         echo "$testcase_dirs"
@@ -61,7 +61,7 @@ jobs:
         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 }}
-      working-directory: testcases/${{ matrix.testcase }}
+      working-directory: packages/uipath-llamaindex/testcases/${{ matrix.testcase }}
       run: |
         echo "Running testcase: ${{ matrix.testcase }}"
         echo "Environment: ${{ matrix.environment }}"

.github/workflows/publish-dev.yml

@@ -7,6 +7,11 @@ on:
 jobs:
   publish-dev:
     runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        package:
+          - name: uipath-llamaindex
+            path: packages/uipath-llamaindex
     permissions:
       contents: read
       pull-requests: write
@@ -36,7 +41,8 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
-          $pyprojcontent = Get-Content pyproject.toml -Raw
+          $pyprojPath = "${{ matrix.package.path }}/pyproject.toml"
+          $pyprojcontent = Get-Content $pyprojPath -Raw
 
           $PROJECT_NAME    = ($pyprojcontent | Select-String -Pattern '(?m)^\[(project|tool\.poetry)\][^\[]*?name\s*=\s*"([^"]*)"' -AllMatches).Matches[0].Groups[2].Value
           $CURRENT_VERSION = ($pyprojcontent | Select-String -Pattern '(?m)^\[(project|tool\.poetry)\][^\[]*?version\s*=\s*"([^"]*)"' -AllMatches).Matches[0].Groups[2].Value
@@ -55,9 +61,9 @@ jobs:
           $DEV_VERSION = "$CURRENT_VERSION.dev1$PADDED_PR$PADDED_RUN"
 
           # Update version in pyproject.toml
-          (Get-Content pyproject.toml) -replace "version = `"$CURRENT_VERSION`"", "version = `"$DEV_VERSION`"" | Set-Content pyproject.toml
+          (Get-Content $pyprojPath) -replace "version = `"$CURRENT_VERSION`"", "version = `"$DEV_VERSION`"" | Set-Content $pyprojPath
 
-          Write-Output "Package version set to $DEV_VERSION"
+          Write-Output "Package $PROJECT_NAME version set to $DEV_VERSION"
 
           $dependencyMessage = @"
           ## Development Package
@@ -119,7 +125,7 @@ jobs:
           Write-Output "Updated PR description with development package information"
 
       - name: Build package
-        run: uv build
+        run: uv build --package ${{ matrix.package.name }}
 
       - name: Publish
         run: uv publish --index testpypi

.github/workflows/publish-docs.yml

@@ -5,13 +5,13 @@ on:
     branches:
       - main
     paths:
-      - "docs/**"
-      - "pyproject.toml"
+      - "packages/*/docs/**"
+      - "packages/*/pyproject.toml"
 
 jobs:
   publish-docs:
     runs-on: ubuntu-latest
-    if: ${{ github.repository == 'UiPath/uipath-llamaindex-python' }}
+    if: ${{ github.repository == 'UiPath/uipath-integrations-python' }}
     steps:
       - name: Trigger Publish Docs
         run: |

.github/workflows/publish.yml

@@ -16,14 +16,18 @@ jobs:
     uses: ./.github/workflows/test.yml
 
   build:
-    name: Build
+    name: Build ${{ matrix.package }}
     runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        package:
+          - uipath-llamaindex
 
     needs:
       - lint
       - test
 
-    if: ${{ github.repository == 'UiPath/uipath-llamaindex-python' }}
+    if: ${{ github.repository == 'UiPath/uipath-integrations-python' }}
     permissions:
       contents: read
       actions: write
@@ -46,18 +50,22 @@ jobs:
         run: uv sync --all-extras
 
       - name: Build
-        run: uv build
+        run: uv build --package ${{ matrix.package }}
 
       - name: Upload artifacts
         uses: actions/upload-artifact@v4
         with:
-          name: release-dists
+          name: release-dists-${{ matrix.package }}
           path: dist/
 
   pypi-publish:
-    name: Upload release to PyPI
+    name: Upload ${{ matrix.package }} to PyPI
     runs-on: ubuntu-latest
     environment: pypi
+    strategy:
+      matrix:
+        package:
+          - uipath-llamaindex
 
     needs:
       - build
@@ -69,7 +77,7 @@ jobs:
       - name: Retrieve release distributions
         uses: actions/download-artifact@v4
         with:
-          name: release-dists
+          name: release-dists-${{ matrix.package }}
           path: dist/
 
       - name: Publish package distributions to PyPI

CONTRIBUTING.md

@@ -34,7 +34,7 @@ See `just --list` for linting, formatting and build commands.
 ### Use SDK Locally
 1. Create a folder on your own device `mkdir project; cd project`
 2. Initialize the python project `uv` `uv init . --python 3.11`
-3. Obtain the project path `PATH_TO_SDK=/Users/YOU_USER/uipath-llamaindex-python/uipath-llamaindex`
+3. Obtain the project path `PATH_TO_SDK=/Users/YOU_USER/uipath-integrations-python/packages/uipath-llamaindex`
 4. Install the sdk in editable mode `uv add --editable ${PATH_TO_SDK}`
 
 :information_source: Instead of cloning the project into `.venv/lib/python3.11/site-packages/uipath-llamaindex`, this mode creates a file named `_uipath-mcp.pth` inside `.venv/lib/python3.11/site-packages`. This file contains the value of `PATH_TO_SDK`, which is added to `sys.path`—the list of directories where python searches for packages. (Run `python -c 'import sys; print(sys.path)'` to see the entries.)

README.md

@@ -1,125 +1,92 @@
-# UiPath LlamaIndex Python SDK
+# UiPath AI Agent Runtimes for Python
+
+A collection of Python SDKs that enable developers to build and deploy AI agents to the UiPath Cloud Platform using different agent frameworks. These packages provide programmatic interaction with UiPath Cloud Platform services and human-in-the-loop (HITL) semantics through Action Center integration.
+
+All packages are extensions to the [UiPath Python SDK](https://github.com/UiPath/uipath-python) and implement the [UiPath Runtime Protocol](https://github.com/UiPath/uipath-runtime-python).
+
+## Available Packages
+
+### UiPath LlamaIndex
 
 [![PyPI - Version](https://img.shields.io/pypi/v/uipath-llamaindex)](https://pypi.org/project/uipath-llamaindex/)
 [![PyPI downloads](https://img.shields.io/pypi/dm/uipath-llamaindex.svg)](https://pypi.org/project/uipath-llamaindex/)
-[![Python versions](https://img.shields.io/pypi/pyversions/uipath-llamaindex.svg)](https://pypi.org/project/uipath-llamaindex/)
-
-A Python SDK that enables developers to build and deploy LlamaIndex agents to the UiPath Cloud Platform. It provides programmatic interaction with UiPath Cloud Platform services and human-in-the-loop (HITL) semantics through Action Center integration.
 
-This package is an extension to the [UiPath Python SDK](https://github.com/UiPath/uipath-python) and implements the [UiPath Runtime Protocol](https://github.com/UiPath/uipath-runtime-python).
+Build agents using the [LlamaIndex](https://www.llamaindex.ai/) framework with support for RAG, multiple LLM providers, and state persistence.
 
-Check out these [sample projects](https://github.com/UiPath/uipath-llamaindex-python/tree/main/samples) to see the SDK in action.
+- **Installation**: `pip install uipath-llamaindex`
+- **Documentation**: [packages/uipath-llamaindex/](packages/uipath-llamaindex/)
+- **Samples**: [packages/uipath-llamaindex/samples/](packages/uipath-llamaindex/samples/)
 
 ## Requirements
 
 -   Python 3.11 or higher
 -   UiPath Automation Cloud account
 
-## Installation
-
-```bash
-pip install uipath-llamaindex
-```
-
-using `uv`:
-
-```bash
-uv add uipath-llamaindex
-```
-
-## Configuration
-
-### Environment Variables
+## Quick Start
 
-Create a `.env` file in your project root with the following variables:
+Follow the installation instructions in the [LlamaIndex documentation](packages/uipath-llamaindex/) to get started building AI agents with RAG capabilities and stateful workflows.
 
-```
-UIPATH_URL=https://cloud.uipath.com/ACCOUNT_NAME/TENANT_NAME
-UIPATH_ACCESS_TOKEN=YOUR_TOKEN_HERE
-```
+## Documentation
 
-## Command Line Interface (CLI)
+- [Quick Start Guide](packages/uipath-llamaindex/docs/quick_start.md)
+- [LlamaIndex Package Documentation](packages/uipath-llamaindex/)
+- [Sample Projects](packages/uipath-llamaindex/samples/)
 
-The SDK provides a command-line interface for creating, packaging, and deploying LlamaIndex Agents:
+## Monorepo Structure
 
-### Initialize a Project
+This repository is organized as a UV workspace:
 
-```bash
-uipath init
 ```
-
-Running `uipath init` will process the workflow definitions in the `llama_index.json` file and create the corresponding `entry-points.json` file needed for deployment.
-
-For more details on the configuration format, see the [UiPath configuration specifications](https://github.com/UiPath/uipath-python/blob/main/specs/README.md).
-
-### Authentication
-
-```bash
-uipath auth
+uipath-integrations-python/
+├── packages/
+│   └── uipath-llamaindex/      # LlamaIndex runtime
+│       ├── docs/                # Documentation
+│       ├── samples/             # Sample projects
+│       └── src/                 # Source code
+└── pyproject.toml              # Workspace configuration
 ```
 
-This command opens a browser for authentication and creates/updates your `.env` file with the proper credentials.
-
-### Debug a Project
-
-```bash
-uipath run WORKFLOW [INPUT]
-```
+## Development
 
-Executes the agent with the provided JSON input arguments.
+### Setting Up a Development Environment
 
-### Package a Project
+This repository uses [UV](https://docs.astral.sh/uv/) for workspace management:
 
 ```bash
-uipath pack
-```
-
-Packages your project into a `.nupkg` file that can be deployed to UiPath.
+# Install UV
+curl -LsSf https://astral.sh/uv/install.sh | sh
 
-**Note:** Your `pyproject.toml` must include:
+# Clone the repository
+git clone https://github.com/UiPath/uipath-integrations-python.git
+cd uipath-integrations-python
 
--   A description field (avoid characters: &, <, >, ", ', ;)
--   Author information
+# Install all dependencies
+uv sync --all-extras
 
-Example:
+# Run tests
+uv run pytest
 
-```toml
-description = "Your package description"
-authors = [{name = "Your Name", email = "your.email@example.com"}]
+# Build the package
+uv build --package uipath-llamaindex
 ```
 
-### Publish a Package
-
-```bash
-uipath publish
-```
-
-Publishes the most recently created package to your UiPath Orchestrator.
-
-## Project Structure
-
-To properly use the CLI for packaging and publishing, your project should include:
-
--   A `pyproject.toml` file with project metadata
--   A `llama_index.json` file with your workflow definitions (e.g., `"workflows": {"agent": "main.py:agent"}`)
--   A `entry-points.json` file (generated by `uipath init`)
--   A `bindings.json` file (generated by `uipath init`) to configure resource overrides
--   Any Python files needed for your automation
-
-## Development
-
 ### Developer Tools
 
 Check out [uipath-dev](https://github.com/uipath/uipath-dev-python) - an interactive terminal application for building, testing, and debugging UiPath Python runtimes, agents, and automation scripts.
 
-### Setting Up a Development Environment
+### Contributing
 
-Please read our [contribution guidelines](https://github.com/UiPath/uipath-llamaindex-python/blob/main/CONTRIBUTING.md) before submitting a pull request.
+Please read our [contribution guidelines](CONTRIBUTING.md) before submitting a pull request.
 
-### Special Thanks
+## Special Thanks
 
 A huge thank-you to the open-source community and the maintainers of the libraries that make this project possible:
 
-- [LlamaIndex](https://github.com/run-llama/llama_index) for providing a powerful framework for building stateful LLM applications.
-- [OpenInference](https://github.com/Arize-ai/openinference) for observability and instrumentation support.
-- [Pydantic](https://github.com/pydantic/pydantic) for reliable, typed configuration and validation.
+- [LlamaIndex](https://github.com/run-llama/llama_index) for providing a powerful framework for building stateful LLM applications
+- [OpenAI](https://github.com/openai) for the Agents framework and APIs
+- [OpenInference](https://github.com/Arize-ai/openinference) for observability and instrumentation support
+- [Pydantic](https://github.com/pydantic/pydantic) for reliable, typed configuration and validation
+
+## License
+
+See [LICENSE](LICENSE) for details.

packages/uipath-llamaindex/README.md

@@ -0,0 +1,42 @@
+# UiPath LlamaIndex SDK
+
+Build intelligent AI agents with LlamaIndex and UiPath.
+
+## Installation
+
+```bash
+pip install uipath-llamaindex
+```
+
+### Optional dependencies
+
+For AWS Bedrock support:
+```bash
+pip install uipath-llamaindex[bedrock]
+```
+
+For Google Vertex AI support:
+```bash
+pip install uipath-llamaindex[vertex]
+```
+
+## Quick Start
+
+See the [main repository documentation](../../docs/quick_start.md) for getting started guides and examples.
+
+## Features
+
+- **LlamaIndex Integration**: Build agents using LlamaIndex's powerful orchestration framework
+- **Multiple LLM Providers**: Support for OpenAI, Azure OpenAI, AWS Bedrock, and Google Vertex AI
+- **RAG Capabilities**: Built-in retrieval-augmented generation with context grounding
+- **State Management**: Resumable workflows with SQLite-based state persistence
+- **Breakpoints & HITL**: Human-in-the-loop support with debugging capabilities
+- **Observability**: Built-in tracing and instrumentation
+
+## Documentation
+
+Full documentation is available in the [main repository](https://github.com/UiPath/uipath-integrations-python).
+
+## License
+
+See [LICENSE](../../LICENSE) in the repository root.

docs/context_grounding.md …ath-llamaindex/docs/context_grounding.mddocs/context_grounding.md renamed to packages/uipath-llamaindex/docs/context_grounding.md docs/context_grounding.md renamed to packages/uipath-llamaindex/docs/context_grounding.md

@@ -70,5 +70,5 @@ response = react_agent.chat("Answer user questions as best as you can using the
 
 
 /// tip
-Check our [travel-helper-RAG-agent sample](https://github.com/UiPath/uipath-llamaindex-python/tree/main/samples/travel-helper-RAG-agent) to see context grounding query engines in action.
+Check our [travel-helper-RAG-agent sample](https://github.com/UiPath/uipath-integrations-python/tree/main/packages/uipath-llamaindex/samples/travel-helper-RAG-agent) to see context grounding query engines in action.
 ///

docs/human_in_the_loop.md …ath-llamaindex/docs/human_in_the_loop.mddocs/human_in_the_loop.md renamed to packages/uipath-llamaindex/docs/human_in_the_loop.md docs/human_in_the_loop.md renamed to packages/uipath-llamaindex/docs/human_in_the_loop.md

@@ -28,7 +28,7 @@ ctx.write_event_to_stream(CreateTaskEvent(app_name="AppName", app_folder_path="M
 task_data = await ctx.wait_for_event(HumanResponseEvent)
 ```
 
-For a practical implementation of the `CreateTaskEvent` model, refer to the [action-center-hitl-agent](https://github.com/UiPath/uipath-llamaindex-python/tree/main/samples/action-center-hitl-agent). This sample demonstrates how to create a task with dynamic input.
+For a practical implementation of the `CreateTaskEvent` model, refer to the [action-center-hitl-agent](https://github.com/UiPath/uipath-integrations-python/tree/main/packages/uipath-llamaindex/samples/action-center-hitl-agent). This sample demonstrates how to create a task with dynamic input.
 
 
 ---
@@ -79,7 +79,7 @@ job_data = await ctx.wait_for_event(HumanResponseEvent)
 An agent can invoke itself if needed, but this must be done with caution. Be mindful that using the same name for invocation may lead to unintentional loops. To prevent recursion issues, implement safeguards like exit conditions.
 ///
 
-For a practical implementation of the `InvokeProcessEvent` model, refer to the [multi-agent sample](https://github.com/UiPath/uipath-llamaindex-python/tree/main/samples/multi-agent). This sample 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.
+For a practical implementation of the `InvokeProcessEvent` model, refer to the [multi-agent sample](https://github.com/UiPath/uipath-integrations-python/tree/main/packages/uipath-llamaindex/samples/multi-agent). This sample 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.
 
 ---