fix: categorize missing HITL index as deployment

packages/uipath-platform/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "uipath-platform"
-version = "0.2.15"
+version = "0.2.16"
 description = "HTTP client library for programmatic access to UiPath Platform"
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.11"

packages/uipath-platform/src/uipath/platform/resume_triggers/_protocol.py

@@ -60,6 +60,7 @@
 from uipath.platform.errors import (
     BatchTransformFailedException,
     BatchTransformNotCompleteException,
+    ContextGroundingIndexNotFoundError,
     OperationNotCompleteException,
 )
 from uipath.platform.orchestrator.job import JobState
@@ -544,6 +545,12 @@ async def create_trigger(self, suspend_value: Any) -> UiPathResumeTrigger:
                         f"Unexpected model received"
                         f"{type(suspend_value)} is not a valid Human-In-The-Loop model",
                     )
+        except ContextGroundingIndexNotFoundError as e:
+            raise UiPathFaultedTriggerError(
+                ErrorCategory.DEPLOYMENT,
+                "Context grounding index not found",
+                str(e),
+            ) from e
         except Exception as e:
             raise UiPathFaultedTriggerError(
                 ErrorCategory.SYSTEM,

packages/uipath-platform/tests/services/test_hitl.py

@@ -67,6 +67,7 @@
     StartExtractionValidationResponse,
     ValidateExtractionAction,
 )
+from uipath.platform.errors import ContextGroundingIndexNotFoundError
 from uipath.platform.orchestrator import Job, JobErrorInfo
 from uipath.platform.orchestrator.job import JobState
 from uipath.platform.resume_triggers import (
@@ -1832,6 +1833,39 @@
                 folder_key=create_batch_transform.index_folder_key,
             )
 
+    @pytest.mark.anyio
+    async def test_missing_batch_transform_index_is_deployment_error(
+        self,
+        setup_test_env: None,
+    ) -> None:
+        create_batch_transform = CreateBatchTransform(
+            name="test-batch-transform",
+            index_name="Files",
+            prompt="test prompt",
+            output_columns=[
+                BatchTransformOutputColumn(name="column1", description="desc1")
+            ],
+            destination_path="/output/path.xlsx",
+            index_folder_path="/test/path",
+        )
+        missing_index = ContextGroundingIndexNotFoundError("Files")
+        mock_start_batch_transform = AsyncMock(side_effect=missing_index)
+
+        with patch(
+            "uipath.platform.context_grounding._context_grounding_service.ContextGroundingService.start_batch_transform_async",
+            new=mock_start_batch_transform,
+        ):
+            with pytest.raises(UiPathFaultedTriggerError) as exc_info:
+                await UiPathResumeTriggerCreator().create_trigger(
+                    create_batch_transform
+                )
+
+        error = exc_info.value
+        assert error.category == ErrorCategory.DEPLOYMENT
+        assert error.message == "Context grounding index not found"
+        assert error.detail == "ContextGroundingIndex 'Files' not found"
+        assert error.__cause__ is missing_index
+
     @pytest.mark.anyio
     async def test_create_resume_trigger_wait_batch_transform(
         self,