uipath-core 0.1.4__py3-none-any.whl → 0.1.6__py3-none-any.whl

uipath/core/guardrails/__init__.py

@@ -16,6 +16,7 @@ from .guardrails import (
     GuardrailScope,
     GuardrailSelector,
     GuardrailValidationResult,
+    GuardrailValidationResultType,
     NumberRule,
     Rule,
     SelectorType,
@@ -43,4 +44,5 @@ __all__ = [
     "GuardrailScope",
     "GuardrailSelector",
     "GuardrailValidationResult",
+    "GuardrailValidationResultType",
 ]

uipath/core/guardrails/_deterministic_guardrails_service.py

@@ -10,10 +10,15 @@ from ._evaluators import (
     evaluate_word_rule,
 )
 from .guardrails import (
+    AllFieldsSelector,
+    ApplyTo,
     BooleanRule,
     DeterministicGuardrail,
+    FieldSource,
     GuardrailValidationResult,
+    GuardrailValidationResultType,
     NumberRule,
+    SpecificFieldsSelector,
     UniversalRule,
     WordRule,
 )
@@ -27,6 +32,16 @@ class DeterministicGuardrailsService(BaseModel):
         guardrail: DeterministicGuardrail,
     ) -> GuardrailValidationResult:
         """Evaluate deterministic guardrail rules against input data (pre-execution)."""
+        # Check if guardrail contains any output-dependent rules
+        has_output_rule = self._has_output_dependent_rule(guardrail, [ApplyTo.OUTPUT])
+
+        # If guardrail has output-dependent rules, skip evaluation in pre-execution
+        # Output rules will be evaluated during post-execution
+        if has_output_rule:
+            return GuardrailValidationResult(
+                result=GuardrailValidationResultType.PASSED,
+                reason="Guardrail contains output-dependent rules that will be evaluated during post-execution",
+            )
         return self._evaluate_deterministic_guardrail(
             input_data=input_data,
             output_data={},
@@ -41,12 +56,61 @@ class DeterministicGuardrailsService(BaseModel):
         guardrail: DeterministicGuardrail,
     ) -> GuardrailValidationResult:
         """Evaluate deterministic guardrail rules against input and output data."""
+        # Check if guardrail contains any output-dependent rules
+        has_output_rule = self._has_output_dependent_rule(
+            guardrail, [ApplyTo.OUTPUT, ApplyTo.INPUT_AND_OUTPUT]
+        )
+
+        # If guardrail has no output-dependent rules, skip post-execution evaluation
+        # Only input rules exist and they should have been evaluated during pre-execution
+        if not has_output_rule:
+            return GuardrailValidationResult(
+                result=GuardrailValidationResultType.PASSED,
+                reason="Guardrail contains only input-dependent rules that were evaluated during pre-execution",
+            )
+
         return self._evaluate_deterministic_guardrail(
             input_data=input_data,
             output_data=output_data,
             guardrail=guardrail,
         )
 
+    @staticmethod
+    def _has_output_dependent_rule(
+        guardrail: DeterministicGuardrail,
+        universal_rules_apply_to_values: list[ApplyTo],
+    ) -> bool:
+        """Check if at least one rule EXCLUSIVELY requires output data.
+
+        Args:
+            guardrail: The guardrail to check
+            universal_rules_apply_to_values: List of ApplyTo values to consider as output-dependent for UniversalRules.
+
+        Returns:
+            True if at least one rule exclusively depends on output data, False otherwise.
+        """
+        for rule in guardrail.rules:
+            # UniversalRule: only return True if it applies to values in universal_rules_apply_to_values
+            if isinstance(rule, UniversalRule):
+                if rule.apply_to in universal_rules_apply_to_values:
+                    return True
+            # Rules with field_selector
+            elif isinstance(rule, (WordRule, NumberRule, BooleanRule)):
+                field_selector = rule.field_selector
+                # AllFieldsSelector applies to both input and output, not exclusively output
+                # SpecificFieldsSelector: only return True if at least one field has OUTPUT source
+                if isinstance(field_selector, SpecificFieldsSelector):
+                    if field_selector.fields and any(
+                        field.source == FieldSource.OUTPUT
+                        for field in field_selector.fields
+                    ):
+                        return True
+                elif isinstance(field_selector, AllFieldsSelector):
+                    if FieldSource.OUTPUT in field_selector.sources:
+                        return True
+
+        return False
+
     @staticmethod
     def _evaluate_deterministic_guardrail(
         input_data: dict[str, Any],
@@ -65,15 +129,17 @@ class DeterministicGuardrailsService(BaseModel):
                 passed, reason = evaluate_universal_rule(rule, output_data)
             else:
                 return GuardrailValidationResult(
-                    validation_passed=False,
+                    result=GuardrailValidationResultType.VALIDATION_FAILED,
                     reason=f"Unknown rule type: {type(rule)}",
                 )
 
             if not passed:
                 return GuardrailValidationResult(
-                    validation_passed=False, reason=reason or "Rule validation failed"
+                    result=GuardrailValidationResultType.VALIDATION_FAILED,
+                    reason=reason or "Rule validation failed",
                 )
 
         return GuardrailValidationResult(
-            validation_passed=True, reason="All deterministic guardrail rules passed"
+            result=GuardrailValidationResultType.PASSED,
+            reason="All deterministic guardrail rules passed",
         )

uipath/core/guardrails/_evaluators.py

@@ -120,23 +120,25 @@ def get_fields_from_selector(
     fields: list[tuple[Any, FieldReference]] = []
 
     if isinstance(field_selector, AllFieldsSelector):
-        # For "all" selector, we need to collect all fields from both input and output
+        # For "all" selector, we need to collect all fields from the specified sources
         # This is a simplified implementation - in practice, you might want to
         # recursively collect all nested fields
-        for key, value in input_data.items():
-            fields.append(
-                (
-                    value,
-                    FieldReference(path=key, source=FieldSource.INPUT),
+        if FieldSource.INPUT in field_selector.sources:
+            for key, value in input_data.items():
+                fields.append(
+                    (
+                        value,
+                        FieldReference(path=key, source=FieldSource.INPUT),
+                    )
                 )
-            )
-        for key, value in output_data.items():
-            fields.append(
-                (
-                    value,
-                    FieldReference(path=key, source=FieldSource.OUTPUT),
+        if FieldSource.OUTPUT in field_selector.sources:
+            for key, value in output_data.items():
+                fields.append(
+                    (
+                        value,
+                        FieldReference(path=key, source=FieldSource.OUTPUT),
+                    )
                 )
-            )
     elif isinstance(field_selector, SpecificFieldsSelector):
         # For specific fields, extract values based on field references
         for field_ref in field_selector.fields:
@@ -286,13 +288,13 @@ def evaluate_universal_rule(
 
     Universal rules trigger based on the apply_to scope and execution phase:
     - Pre-execution (empty output_data):
-      - INPUT: triggers (validation_passed = False)
-      - OUTPUT: does not trigger (validation_passed = True)
-      - INPUT_AND_OUTPUT: triggers (validation_passed = False)
+      - INPUT: triggers (result = VALIDATION_FAILED)
+      - OUTPUT: does not trigger (result = PASSED)
+      - INPUT_AND_OUTPUT: triggers (result = VALIDATION_FAILED)
     - Post-execution (output_data has data):
-      - INPUT: does not trigger (validation_passed = True)
-      - OUTPUT: triggers (validation_passed = False)
-      - INPUT_AND_OUTPUT: triggers (validation_passed = False)
+      - INPUT: does not trigger (result = PASSED)
+      - OUTPUT: triggers (result = VALIDATION_FAILED)
+      - INPUT_AND_OUTPUT: triggers (result = VALIDATION_FAILED)
     """
     # Determine if this is pre-execution (no output data) or post-execution
     is_pre_execution = not output_data or len(output_data) == 0

uipath/core/guardrails/guardrails.py

@@ -6,18 +6,27 @@ from typing import Annotated, Callable, Literal
 from pydantic import BaseModel, ConfigDict, Field
 
 
+class GuardrailValidationResultType(str, Enum):
+    """Guardrail validation result type enumeration."""
+
+    PASSED = "passed"
+    VALIDATION_FAILED = "validation_failed"
+    ENTITLEMENTS_MISSING = "entitlements_missing"
+    FEATURE_DISABLED = "feature_disabled"
+
+
 class GuardrailValidationResult(BaseModel):
     """Result returned from validating input with a given guardrail.
 
     Attributes:
-        validation_passed: Indicates whether the input data passed the guardrail validation.
+        result: The validation result type.
         reason: Textual explanation describing why the validation passed or failed.
     """
 
     model_config = ConfigDict(populate_by_name=True)
 
-    validation_passed: bool = Field(
-        alias="validation_passed", description="Whether the input passed validation."
+    result: GuardrailValidationResultType = Field(
+        alias="result", description="Validation result."
     )
     reason: str = Field(
         alias="reason", description="Explanation for the validation result."
@@ -59,6 +68,7 @@ class AllFieldsSelector(BaseModel):
     """All fields selector."""
 
     selector_type: Literal["all"] = Field(alias="$selectorType")
+    sources: list[FieldSource]
 
     model_config = ConfigDict(populate_by_name=True, extra="allow")
 

{uipath_core-0.1.4.dist-info → uipath_core-0.1.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: uipath-core
-Version: 0.1.4
+Version: 0.1.6
 Summary: UiPath Core abstractions
 Project-URL: Homepage, https://uipath.com
 Project-URL: Repository, https://github.com/UiPath/uipath-core-python

{uipath_core-0.1.4.dist-info → uipath_core-0.1.6.dist-info}/RECORD

@@ -14,10 +14,10 @@ uipath/core/chat/meta.py,sha256=3t0eS9UHoAPHre97QTUeVbjDhnMX4zj4-qG6ju0B8wY,315
 uipath/core/chat/tool.py,sha256=6e5pyX3hOWM5fIzr_fdG49Mbzz6XzJD3nsmha-yGa2k,2308
 uipath/core/errors/__init__.py,sha256=gjxdLibZ0fjwgzPuLJY04P8dIX9rbSM2wQ97jP34ucE,278
 uipath/core/errors/errors.py,sha256=5LajjuTfNW82ju07wT5mD3tXk0S-Ju7OqJqQpPN0F6g,486
-uipath/core/guardrails/__init__.py,sha256=baH9Vj8f6spKOpxv3dUl5UKg-LWthaoZ0RidtlFjyEQ,956
-uipath/core/guardrails/_deterministic_guardrails_service.py,sha256=3WGcgpyUIvTXBvheEXjX-XguytxquWJkBevrVeM2tcc,2841
-uipath/core/guardrails/_evaluators.py,sha256=5llj14Xh1mzREh8JC9LjsymGsuGrz8x6Sv6K5s4P1sE,14446
-uipath/core/guardrails/guardrails.py,sha256=X2EVZVhD2PSXmfudgLdPB9ccsyqfPWESzuOzH9MGCrg,4703
+uipath/core/guardrails/__init__.py,sha256=hUCmD4y5te2iy01YnJlBuf2RWvqxmsNzoyOamXLXf2E,1028
+uipath/core/guardrails/_deterministic_guardrails_service.py,sha256=uX8f2HSGZ1bf5QFM9fnz0CvglxI3UIqY4OhHrKzemaU,5967
+uipath/core/guardrails/_evaluators.py,sha256=ovmVm-8iB8Pm9arjG7mHM9-GIRkrG3V6oHRPHKxZVO0,14601
+uipath/core/guardrails/guardrails.py,sha256=DraeFkoDKVDnc0EKdFYYP29lQu7U2hneTsj1dxveHU4,4935
 uipath/core/tracing/__init__.py,sha256=1XNLYZ4J76XkRrizGO486mS6yxzVXUbrldpvxTyJe3E,483
 uipath/core/tracing/_utils.py,sha256=FiCFGOFa4czruhlSF87Q5Q4jX9KKPHZiw8k14K7W5v4,6636
 uipath/core/tracing/decorators.py,sha256=ag_MFwZ0TywrhbpLKqQwF1guvRA9sYiItxao5LN9_Iw,10942
@@ -25,7 +25,7 @@ uipath/core/tracing/exporters.py,sha256=FClouEEQfk3F8J7G_NFoarDJM3R0-gA5jUxA5xRH
 uipath/core/tracing/processors.py,sha256=R_652rtjPmfpUtaXoIcmfZrRZylVXFRNwjOmJUUxOQw,1408
 uipath/core/tracing/span_utils.py,sha256=WYBrd6ZbawAs7r1Js-Zvo9_8GzkD9LhHNOls00bK_xI,12235
 uipath/core/tracing/trace_manager.py,sha256=51rscJcepkTK4bWoCZdE-DFc9wt2F-aSuFBaSXmkHl0,3130
-uipath_core-0.1.4.dist-info/METADATA,sha256=z8rkXBn1096teW-f17J-a5QNegco4Qm02xWVvutjwQQ,938
-uipath_core-0.1.4.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-uipath_core-0.1.4.dist-info/licenses/LICENSE,sha256=-KBavWXepyDjimmzH5fVAsi-6jNVpIKFc2kZs0Ri4ng,1058
-uipath_core-0.1.4.dist-info/RECORD,,
+uipath_core-0.1.6.dist-info/METADATA,sha256=R2wS5I85yHd-uTvGgepwbhKiZA7cLb389XJ5R57ED7I,938
+uipath_core-0.1.6.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+uipath_core-0.1.6.dist-info/licenses/LICENSE,sha256=-KBavWXepyDjimmzH5fVAsi-6jNVpIKFc2kZs0Ri4ng,1058
+uipath_core-0.1.6.dist-info/RECORD,,