uipath 2.0.66__tar.gz → 2.0.68__tar.gz

{uipath-2.0.66 → uipath-2.0.68}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: uipath
-Version: 2.0.66
+Version: 2.0.68
 Summary: Python SDK and CLI for UiPath Platform, enabling programmatic interaction with automation services, process management, and deployment tools.
 Project-URL: Homepage, https://uipath.com
 Project-URL: Repository, https://github.com/UiPath/uipath-python

{uipath-2.0.66 → uipath-2.0.68}/docs/cli/index.md

@@ -54,9 +54,10 @@ For step-by-step debugging with breakpoints and variable inspection (supported f
 # Run agent with debugging enabled
 uipath run [ENTRYPOINT] [INPUT] --debug
 ```
-For vscode: add the [debug configuration](https://github.com/UiPath/uipath-python/blob/main/.vscode/launch.json) in your .vscode/launch.json file.
-Place breakpoints in your code where needed.
-Use the shortcut `F5`, or navigate to Run -> Start Debugging -> Python Debugger: Attach
+For vscode:
+1. add the [debug configuration](https://github.com/UiPath/uipath-python/blob/main/.vscode/launch.json) in your `.vscode/launch.json` file.
+2. Place breakpoints in your code where needed.
+3. Use the shortcut `F5`, or navigate to Run -> Start Debugging -> Python Debugger: Attach.
 
 Upon starting the debugging process, one should see the following logs in terminal:
 ```console
@@ -106,6 +107,38 @@ uipath run agent '{\"topic\":\"uipath\"}'
 
 Packages your project into a `.nupkg` file that can be deployed to UiPath.
 
+/// info
+### Default Files Included in `.nupkg`
+
+By default, the following file types are included in the `.nupkg` file:
+
+- `.py`
+- `.mermaid`
+- `.json`
+- `.yaml`
+- `.yml`
+
+---
+
+### Including Extra Files
+
+To include additional files, update the `uipath.json` file by adding a `settings` section. Use the following configuration format:
+
+```json
+{
+    "settings": {
+        "filesIncluded": [
+            "<file here>"
+        ],
+        "fileExtensionsIncluded": [
+            "<new file extension to include (e.g., 'go')>"
+        ]
+    }
+}
+```
+
+///
+
 /// warning
 Your `pyproject.toml` must include:
 

{uipath-2.0.66 → uipath-2.0.68}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "uipath"
-version = "2.0.66"
+version = "2.0.68"
 description = "Python SDK and CLI for UiPath Platform, enabling programmatic interaction with automation services, process management, and deployment tools."
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.10"

{uipath-2.0.66 → uipath-2.0.68}/src/uipath/_services/context_grounding_service.py

@@ -673,7 +673,7 @@ class ContextGroundingService(FolderContext, BaseService):
             )
 
         if folder_key is None:
-            raise ValueError("Folder key or folder path is required")
+            raise ValueError("ContextGrounding: Failed to resolve folder key")
 
         return folder_key
 
@@ -681,4 +681,6 @@ class ContextGroundingService(FolderContext, BaseService):
         try:
             return index.data_source.bucketName, index.data_source.folder  # type: ignore
         except AttributeError as e:
-            raise Exception("Cannot extract bucket data from index") from e
+            raise Exception(
+                "ContextGrounding: Cannot extract bucket data from index"
+            ) from e

{uipath-2.0.66 → uipath-2.0.68}/src/uipath/_services/folder_service.py

@@ -28,23 +28,49 @@ class FolderService(BaseService):
 
     @traced(name="folder_retrieve_key", run_type="uipath")
     def retrieve_key(self, *, folder_path: str) -> Optional[str]:
-        spec = self._retrieve_spec(folder_path)
-        response = self.request(
-            spec.method,
-            url=spec.endpoint,
-            params=spec.params,
-        ).json()
-
-        return next(
-            (
-                item["Key"]
-                for item in response["PageItems"]
-                if item["FullyQualifiedName"] == folder_path
-            ),
-            None,
-        )
+        """Retrieve the folder key by folder path with pagination support.
+
+        Args:
+            folder_path: The fully qualified folder path to search for.
+
+        Returns:
+            The folder key if found, None otherwise.
+        """
+        skip = 0
+        take = 20
+
+        while True:
+            spec = self._retrieve_spec(folder_path, skip=skip, take=take)
+            response = self.request(
+                spec.method,
+                url=spec.endpoint,
+                params=spec.params,
+            ).json()
+
+            # Search for the folder in current page
+            folder_key = next(
+                (
+                    item["Key"]
+                    for item in response["PageItems"]
+                    if item["FullyQualifiedName"] == folder_path
+                ),
+                None,
+            )
+
+            if folder_key is not None:
+                return folder_key
+
+            page_items = response["PageItems"]
+            if len(page_items) < take:
+                break
+
+            skip += take
+
+        return None
 
-    def _retrieve_spec(self, folder_path: str) -> RequestSpec:
+    def _retrieve_spec(
+        self, folder_path: str, *, skip: int = 0, take: int = 20
+    ) -> RequestSpec:
         folder_name = folder_path.split("/")[-1]
         return RequestSpec(
             method="GET",
@@ -53,6 +79,7 @@ class FolderService(BaseService):
             ),
             params={
                 "searchText": folder_name,
-                "take": 1,
+                "skip": skip,
+                "take": take,
             },
         )

{uipath-2.0.66 → uipath-2.0.68}/tests/sdk/services/test_context_grounding_service.py

@@ -38,7 +38,7 @@ class TestContextGroundingService:
         version: str,
     ) -> None:
         httpx_mock.add_response(
-            url=f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=test-folder-path&take=1",
+            url=f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=test-folder-path&skip=0&take=20",
             status_code=200,
             json={
                 "PageItems": [
@@ -68,7 +68,7 @@ class TestContextGroundingService:
         )
 
         httpx_mock.add_response(
-            url=f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=test-folder-path&take=1",
+            url=f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=test-folder-path&skip=0&take=20",
             status_code=200,
             json={
                 "PageItems": [
@@ -132,7 +132,7 @@ class TestContextGroundingService:
         version: str,
     ) -> None:
         httpx_mock.add_response(
-            url=f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=test-folder-path&take=1",
+            url=f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=test-folder-path&skip=0&take=20",
             status_code=200,
             json={
                 "PageItems": [
@@ -162,7 +162,7 @@ class TestContextGroundingService:
         )
 
         httpx_mock.add_response(
-            url=f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=test-folder-path&take=1",
+            url=f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=test-folder-path&skip=0&take=20",
             status_code=200,
             json={
                 "PageItems": [
@@ -225,7 +225,7 @@ class TestContextGroundingService:
         version: str,
     ) -> None:
         httpx_mock.add_response(
-            url=f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=test-folder-path&take=1",
+            url=f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=test-folder-path&skip=0&take=20",
             status_code=200,
             json={
                 "PageItems": [
@@ -285,7 +285,7 @@ class TestContextGroundingService:
         version: str,
     ) -> None:
         httpx_mock.add_response(
-            url=f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=test-folder-path&take=1",
+            url=f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=test-folder-path&skip=0&take=20",
             status_code=200,
             json={
                 "PageItems": [
@@ -296,7 +296,6 @@ class TestContextGroundingService:
                 ]
             },
         )
-
         httpx_mock.add_response(
             url=f"{base_url}{org}{tenant}/ecs_/v2/indexes?$filter=Name eq 'test-index'&$expand=dataSource",
             status_code=200,

uipath-2.0.68/tests/sdk/services/test_folder_service.py

@@ -0,0 +1,370 @@
+import pytest
+from pytest_httpx import HTTPXMock
+
+from uipath._config import Config
+from uipath._execution_context import ExecutionContext
+from uipath._services.folder_service import FolderService
+from uipath._utils.constants import HEADER_USER_AGENT
+
+
+@pytest.fixture
+def service(
+    config: Config,
+    execution_context: ExecutionContext,
+    monkeypatch: pytest.MonkeyPatch,
+) -> FolderService:
+    monkeypatch.setenv("UIPATH_FOLDER_PATH", "test-folder-path")
+    return FolderService(config=config, execution_context=execution_context)
+
+
+class TestFolderService:
+    def test_retrieve_key_by_folder_path(
+        self,
+        httpx_mock: HTTPXMock,
+        service: FolderService,
+        base_url: str,
+        org: str,
+        tenant: str,
+        version: str,
+    ) -> None:
+        httpx_mock.add_response(
+            url=f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=test-folder-path&skip=0&take=20",
+            status_code=200,
+            json={
+                "PageItems": [
+                    {
+                        "Key": "test-folder-key",
+                        "FullyQualifiedName": "test-folder-path",
+                    }
+                ]
+            },
+        )
+
+        with pytest.warns(DeprecationWarning, match="Use retrieve_key instead"):
+            folder_key = service.retrieve_key_by_folder_path("test-folder-path")
+
+        assert folder_key == "test-folder-key"
+
+        sent_request = httpx_mock.get_request()
+        if sent_request is None:
+            raise Exception("No request was sent")
+
+        assert sent_request.method == "GET"
+        assert (
+            sent_request.url
+            == f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=test-folder-path&skip=0&take=20"
+        )
+
+        assert HEADER_USER_AGENT in sent_request.headers
+        assert (
+            sent_request.headers[HEADER_USER_AGENT]
+            == f"UiPath.Python.Sdk/UiPath.Python.Sdk.Activities.FolderService.retrieve_key/{version}"
+        )
+
+    def test_retrieve_key_by_folder_path_not_found(
+        self,
+        httpx_mock: HTTPXMock,
+        service: FolderService,
+        base_url: str,
+        org: str,
+        tenant: str,
+        version: str,
+    ) -> None:
+        httpx_mock.add_response(
+            url=f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=non-existent-folder&skip=0&take=20",
+            status_code=200,
+            json={"PageItems": []},
+        )
+
+        with pytest.warns(DeprecationWarning, match="Use retrieve_key instead"):
+            folder_key = service.retrieve_key_by_folder_path("non-existent-folder")
+
+        assert folder_key is None
+
+        sent_request = httpx_mock.get_request()
+        if sent_request is None:
+            raise Exception("No request was sent")
+
+        assert sent_request.method == "GET"
+        assert (
+            sent_request.url
+            == f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=non-existent-folder&skip=0&take=20"
+        )
+
+        assert HEADER_USER_AGENT in sent_request.headers
+        assert (
+            sent_request.headers[HEADER_USER_AGENT]
+            == f"UiPath.Python.Sdk/UiPath.Python.Sdk.Activities.FolderService.retrieve_key/{version}"
+        )
+
+    def test_retrieve_key(
+        self,
+        httpx_mock: HTTPXMock,
+        service: FolderService,
+        base_url: str,
+        org: str,
+        tenant: str,
+        version: str,
+    ) -> None:
+        httpx_mock.add_response(
+            url=f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=test-folder-path&skip=0&take=20",
+            status_code=200,
+            json={
+                "PageItems": [
+                    {
+                        "Key": "test-folder-key",
+                        "FullyQualifiedName": "test-folder-path",
+                    }
+                ]
+            },
+        )
+
+        folder_key = service.retrieve_key(folder_path="test-folder-path")
+
+        assert folder_key == "test-folder-key"
+
+        sent_request = httpx_mock.get_request()
+        if sent_request is None:
+            raise Exception("No request was sent")
+
+        assert sent_request.method == "GET"
+        assert (
+            sent_request.url
+            == f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=test-folder-path&skip=0&take=20"
+        )
+
+        assert HEADER_USER_AGENT in sent_request.headers
+        assert (
+            sent_request.headers[HEADER_USER_AGENT]
+            == f"UiPath.Python.Sdk/UiPath.Python.Sdk.Activities.FolderService.retrieve_key/{version}"
+        )
+
+    def test_retrieve_key_not_found(
+        self,
+        httpx_mock: HTTPXMock,
+        service: FolderService,
+        base_url: str,
+        org: str,
+        tenant: str,
+        version: str,
+    ) -> None:
+        httpx_mock.add_response(
+            url=f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=non-existent-folder&skip=0&take=20",
+            status_code=200,
+            json={"PageItems": []},
+        )
+
+        folder_key = service.retrieve_key(folder_path="non-existent-folder")
+
+        assert folder_key is None
+
+        sent_request = httpx_mock.get_request()
+        if sent_request is None:
+            raise Exception("No request was sent")
+
+        assert sent_request.method == "GET"
+        assert (
+            sent_request.url
+            == f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=non-existent-folder&skip=0&take=20"
+        )
+
+        assert HEADER_USER_AGENT in sent_request.headers
+        assert (
+            sent_request.headers[HEADER_USER_AGENT]
+            == f"UiPath.Python.Sdk/UiPath.Python.Sdk.Activities.FolderService.retrieve_key/{version}"
+        )
+
+    def test_retrieve_key_found_on_second_page(
+        self,
+        httpx_mock: HTTPXMock,
+        service: FolderService,
+        base_url: str,
+        org: str,
+        tenant: str,
+        version: str,
+    ) -> None:
+        """Test that retrieve_key can find a folder on subsequent pages through pagination."""
+        # First page - folder not found
+        httpx_mock.add_response(
+            url=f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=target-folder&skip=0&take=20",
+            status_code=200,
+            json={
+                "PageItems": [
+                    {
+                        "Key": f"folder-key-{i}",
+                        "FullyQualifiedName": f"other-folder-{i}",
+                    }
+                    for i in range(20)  # Full page of 20 items, none matching
+                ]
+            },
+        )
+
+        # Second page - folder found
+        httpx_mock.add_response(
+            url=f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=target-folder&skip=20&take=20",
+            status_code=200,
+            json={
+                "PageItems": [
+                    {
+                        "Key": "target-folder-key",
+                        "FullyQualifiedName": "target-folder",
+                    },
+                    {
+                        "Key": "another-folder-key",
+                        "FullyQualifiedName": "another-folder",
+                    },
+                ]
+            },
+        )
+
+        folder_key = service.retrieve_key(folder_path="target-folder")
+
+        assert folder_key == "target-folder-key"
+
+        requests = httpx_mock.get_requests()
+        assert len(requests) == 2
+
+        assert requests[0].method == "GET"
+        assert (
+            requests[0].url
+            == f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=target-folder&skip=0&take=20"
+        )
+
+        assert requests[1].method == "GET"
+        assert (
+            requests[1].url
+            == f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=target-folder&skip=20&take=20"
+        )
+
+    def test_retrieve_key_not_found_after_pagination(
+        self,
+        httpx_mock: HTTPXMock,
+        service: FolderService,
+        base_url: str,
+        org: str,
+        tenant: str,
+        version: str,
+    ) -> None:
+        """Test that retrieve_key returns None when folder is not found after paginating through all results."""
+        # First page - full page, no match
+        httpx_mock.add_response(
+            url=f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=missing-folder&skip=0&take=20",
+            status_code=200,
+            json={
+                "PageItems": [
+                    {
+                        "Key": f"folder-key-{i}",
+                        "FullyQualifiedName": f"other-folder-{i}",
+                    }
+                    for i in range(20)  # Full page of 20 items
+                ]
+            },
+        )
+
+        # Second page - no match
+        httpx_mock.add_response(
+            url=f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=missing-folder&skip=20&take=20",
+            status_code=200,
+            json={
+                "PageItems": [
+                    {
+                        "Key": "final-folder-key",
+                        "FullyQualifiedName": "final-folder",
+                    },
+                ]
+            },
+        )
+
+        folder_key = service.retrieve_key(folder_path="missing-folder")
+
+        assert folder_key is None
+
+        requests = httpx_mock.get_requests()
+        assert len(requests) == 2
+
+        assert requests[0].method == "GET"
+        assert (
+            requests[0].url
+            == f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=missing-folder&skip=0&take=20"
+        )
+
+        assert requests[1].method == "GET"
+        assert (
+            requests[1].url
+            == f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=missing-folder&skip=20&take=20"
+        )
+
+    def test_retrieve_key_found_on_third_page(
+        self,
+        httpx_mock: HTTPXMock,
+        service: FolderService,
+        base_url: str,
+        org: str,
+        tenant: str,
+        version: str,
+    ) -> None:
+        """Test that retrieve_key can find a folder on the third page through multiple pagination requests."""
+        # First page
+        httpx_mock.add_response(
+            url=f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=deep-folder&skip=0&take=20",
+            status_code=200,
+            json={
+                "PageItems": [
+                    {
+                        "Key": f"folder-key-{i}",
+                        "FullyQualifiedName": f"page1-folder-{i}",
+                    }
+                    for i in range(20)
+                ]
+            },
+        )
+
+        # Second page
+        httpx_mock.add_response(
+            url=f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=deep-folder&skip=20&take=20",
+            status_code=200,
+            json={
+                "PageItems": [
+                    {
+                        "Key": f"folder-key-{i}",
+                        "FullyQualifiedName": f"page2-folder-{i}",
+                    }
+                    for i in range(20)
+                ]
+            },
+        )
+
+        # Third page - folder found
+        httpx_mock.add_response(
+            url=f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=deep-folder&skip=40&take=20",
+            status_code=200,
+            json={
+                "PageItems": [
+                    {
+                        "Key": "some-other-key",
+                        "FullyQualifiedName": "some-other-folder",
+                    },
+                    {
+                        "Key": "deep-folder-key",
+                        "FullyQualifiedName": "deep-folder",
+                    },
+                ]
+            },
+        )
+
+        folder_key = service.retrieve_key(folder_path="deep-folder")
+
+        assert folder_key == "deep-folder-key"
+
+        requests = httpx_mock.get_requests()
+        assert len(requests) == 3
+
+        expected_urls = [
+            f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=deep-folder&skip=0&take=20",
+            f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=deep-folder&skip=20&take=20",
+            f"{base_url}{org}{tenant}/orchestrator_/api/FoldersNavigation/GetFoldersForCurrentUser?searchText=deep-folder&skip=40&take=20",
+        ]
+
+        for i, request in enumerate(requests):
+            assert request.method == "GET"
+            assert request.url == expected_urls[i]

{uipath-2.0.66 → uipath-2.0.68}/uv.lock

@@ -3111,7 +3111,7 @@ wheels = [
 
 [[package]]
 name = "uipath"
-version = "2.0.66"
+version = "2.0.68"
 source = { editable = "." }
 dependencies = [
     { name = "azure-monitor-opentelemetry" },