fix: update to the new contracts

Author: cristipufu

.github/workflows/test.yml

@@ -9,7 +9,7 @@ jobs:
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.11", "3.12", "3.13"]
         os: [ubuntu-latest, windows-latest]
 
     permissions:

.python-version

@@ -1 +1 @@
-3.10
+3.11

CONTRIBUTING.md

@@ -33,10 +33,10 @@ 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.10`
-3. Obtain the project path `PATH_TO_SDK=/Users/YOU_USER/uipath-mcp-python/uipath-mcp`
+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`
 4. Install the sdk in editable mode `uv add --editable ${PATH_TO_SDK}`
 
-:information_source: Instead of cloning the project into `.venv/lib/python3.10/site-packages/uipath-mcp`, this mode creates a file named `_uipath-mcp.pth` inside `.venv/lib/python3.10/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.)
+: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

@@ -11,7 +11,7 @@ Check out these [sample projects](https://github.com/UiPath/uipath-llamaindex-py
 
 ## Requirements
 
--   Python 3.10 or higher
+-   Python 3.11 or higher
 -   UiPath Automation Cloud account
 
 ## Installation
@@ -44,10 +44,12 @@ The SDK provides a command-line interface for creating, packaging, and deploying
 ### Initialize a Project
 
 ```bash
-uipath init [WORKFLOW]
+uipath init
 ```
 
-Creates a `uipath.json` configuration file for your project. If `[WORKFLOW]` is omitted, it will create an entrypoint for each workflow specified in the `llama_index.json` file.
+Running `uipath init` will process the graph 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
 
@@ -98,8 +100,9 @@ Publishes the most recently created package to your UiPath Orchestrator.
 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
--   A `uipath.json` file (generated by `uipath init`)
+-   A `llama_index.json` file with your graph 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

docs/quick_start.md

@@ -8,7 +8,7 @@ This guide provides step-by-step instructions for setting up, creating, publishi
 
 Before proceeding, ensure you have the following installed:
 
--   Python 3.10 or higher
+-   Python 3.11 or higher
 -   `pip` or `uv` package manager
 -   A UiPath Automation Cloud account with appropriate permissions
 -   An OpenAI API key
@@ -50,12 +50,12 @@ We recommend using `uv` for package management. To create a new project:
 
 ```shell
 # Initialize a new uv project in the current directory
-> uv init . --python 3.10
+> uv init . --python 3.11
 
 # Create a new virtual environment
 # By default, uv creates a virtual environment in a directory called .venv
 > uv venv
-Using CPython 3.10.16 interpreter at: [PATH]
+Using CPython 3.11.16 interpreter at: [PATH]
 Creating virtual environment at: .venv
 Activate with: source .venv/bin/activate
 
@@ -127,7 +127,7 @@ This command creates the following files:
 ⠋ Initializing UiPath project ...
 ✓   Created '.env' file.
 ✓   Created 'agent.mermaid' file.
-✓   Created 'uipath.json' file.
+✓   Created 'entry-points.json' file.
 ```
 
 This command creates the following files:

pyproject.toml

@@ -1,23 +1,22 @@
 [project]
 name = "uipath-llamaindex"
-version = "0.0.38"
+version = "0.1.0"
 description = "UiPath LlamaIndex SDK"
 readme = { file = "README.md", content-type = "text/markdown" }
-requires-python = ">=3.10"
+requires-python = ">=3.11"
 dependencies = [
-    "llama-index>=0.12.38",
-    "llama-index-embeddings-azure-openai>=0.3.8",
-    "llama-index-llms-azure-openai>=0.3.2",
-    "openinference-instrumentation-llama-index>=4.3.0",
-    "uipath>=2.1.108, <2.2.0",
+    "llama-index>=0.14.8",
+    "llama-index-embeddings-azure-openai>=0.4.1",
+    "llama-index-llms-azure-openai>=0.4.2",
+    "openinference-instrumentation-llama-index>=4.3.9",
+    "uipath>=2.2.7, <2.3.0",
 ]
 classifiers = [
-    "Development Status :: 3 - Alpha",
     "Intended Audience :: Developers",
     "Topic :: Software Development :: Build Tools",
-    "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
 ]
 maintainers = [
     { name = "Marius Cosareanu", email = "marius.cosareanu@uipath.com" },
@@ -27,6 +26,9 @@ maintainers = [
 [project.entry-points."uipath.middlewares"]
 register = "uipath_llamaindex.middlewares:register_middleware"
 
+[project.entry-points."uipath.runtime.factories"]
+llamaindex = "uipath_llamaindex.runtime:register_runtime_factory"
+
 [project.urls]
 Homepage = "https://uipath.com"
 Repository = "https://github.com/UiPath/uipath-llamaindex-python"
@@ -69,22 +71,19 @@ plugins = [
 exclude = [
     "samples/.*", "testcases/.*"
 ]
-
 follow_imports = "silent"
 warn_redundant_casts = true
 warn_unused_ignores = true
 disallow_any_generics = true
 check_untyped_defs = true
 no_implicit_reexport = true
-
 disallow_untyped_defs = false
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 python_files = "test_*.py"
 addopts = "-ra -q"
 
-
 [[tool.uv.index]]
 name = "testpypi"
 url = "https://test.pypi.org/simple/"

samples/action-center-hitl-agent/pyproject.toml

@@ -4,8 +4,8 @@ version = "0.0.1"
 description = "UiPath LlamaIndex Simple HITL Agent"
 authors = [{ name = "John Doe", email = "john.doe@myemail.com" }]
 readme = { file = "README.md", content-type = "text/markdown" }
-requires-python = ">=3.10"
+requires-python = ">=3.11"
 dependencies = [
-    "uipath-llamaindex>=0.0.36, <0.1.0",
+    "uipath-llamaindex>=0.1.0, <0.2.0",
     "llama-index-llms-openai>=0.2.2"
 ]

samples/image-gen-agent/pyproject.toml

@@ -4,9 +4,9 @@ version = "0.0.4"
 description = "UiPath LlamaIndex Image Generation Agent"
 authors = [{ name = "John Doe", email = "john.doe@myemail.com" }]
 readme = { file = "README.md", content-type = "text/markdown" }
-requires-python = ">=3.10"
+requires-python = ">=3.11"
 dependencies = [
-    "uipath-llamaindex>=0.0.36, <0.1.0",
+    "uipath-llamaindex>=0.1.0, <0.2.0",
     "llama-index-llms-openai>=0.3.44",
     "llama-index-tools-openai-image-generation>=0.4.0"
 ]

samples/multi-agent/pyproject.toml

@@ -4,8 +4,8 @@ version = "0.0.1"
 description = "UiPath LlamaIndex Simple HITL Agent"
 authors = [{ name = "John Doe", email = "john.doe@myemail.com" }]
 readme = { file = "README.md", content-type = "text/markdown" }
-requires-python = ">=3.10"
+requires-python = ">=3.11"
 dependencies = [
-    "uipath-llamaindex>=0.0.36, <0.1.0",
+    "uipath-llamaindex>=0.1.0, <0.2.0",
     "llama-index-llms-openai>=0.2.2"
 ]

samples/multi-modal-book-writer-agent/README.md

@@ -61,6 +61,6 @@ This sample demonstrates how UiPath can handle complex multi-modal workflows tha
 
 ## Dependencies
 
-- Python ≥3.10
+- Python ≥ 3.11
 - UiPath LlamaIndex integration
 - OpenAI API (for text and image generation)