uipath 2.1.75__tar.gz → 2.1.76__tar.gz

{uipath-2.1.75 → uipath-2.1.76}/CONTRIBUTING.md

@@ -21,7 +21,21 @@
     uv venv
     ```
 
-4. **Install dependencies**:
+4. **Activate the virtual environment**:
+    - Linux/Mac
+    ```sh
+    source .venv/bin/activate
+    ```
+    - Windows Powershell
+    ```sh
+    .venv\Scripts\Activate.ps1
+    ```
+    - Windows Bash
+    ```sh
+    source .venv/Scripts/activate
+    ```
+
+5. **Install dependencies**:
     ```sh
     uv sync --all-extras --no-cache
     ```

{uipath-2.1.75 → uipath-2.1.76}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: uipath
-Version: 2.1.75
+Version: 2.1.76
 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.1.75 → uipath-2.1.76}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "uipath"
-version = "2.1.75"
+version = "2.1.76"
 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.1.75 → uipath-2.1.76}/src/uipath/_cli/_evals/_console_progress_reporter.py

@@ -75,15 +75,10 @@ class ConsoleProgressReporter:
             result.append(" - No evaluators", style="dim")
             self.console.print(result)
 
-    def _extract_error_message(self, eval_item_payload) -> str:
-        """Extract clean error message from evaluation item."""
-        if hasattr(eval_item_payload, "_error_message"):
-            error_message = getattr(eval_item_payload, "_error_message", None)
-            if error_message:
-                return str(error_message) or "Execution failed"
-        return "Execution failed"
-
-    def _display_failed_evaluation(self, eval_name: str, error_msg: str) -> None:
+    def _extract_error_message(self, payload: EvalRunUpdatedEvent) -> str:
+        return str(payload.exception_details.exception) or "Execution failed"  # type: ignore
+
+    def _display_failed_evaluation(self, eval_name: str) -> None:
         """Display results for a failed evaluation."""
         from rich.text import Text
 
@@ -92,11 +87,6 @@ class ConsoleProgressReporter:
         result.append(eval_name, style="bold white")
         self.console.print(result)
 
-        error_text = Text()
-        error_text.append("    ", style="")
-        error_text.append(error_msg, style="red")
-        self.console.print(error_text)
-
     def start_display(self):
         """Start the display."""
         if not self.display_started:
@@ -122,37 +112,47 @@ class ConsoleProgressReporter:
         except Exception as e:
             logger.error(f"Failed to handle create eval run event: {e}")
 
+    def _display_logs_panel(self, eval_name: str, logs, error_msg: str = "") -> None:
+        """Display execution logs panel with optional exception at the end."""
+        self.console.print(
+            Rule(
+                f"[dim italic]Execution Logs: {eval_name}[/dim italic]",
+                style="dim",
+                align="center",
+            )
+        )
+
+        if logs:
+            for record in logs:
+                self.console.print(f"  [dim]{record.getMessage()}[/dim]")
+        elif not error_msg:
+            self.console.print("  [dim italic]No execution logs[/dim italic]")
+
+        if error_msg:
+            self.console.print(f"  [red]{error_msg}[/red]")
+
+        self.console.print(Rule(style="dim"))
+
     async def handle_update_eval_run(self, payload: EvalRunUpdatedEvent) -> None:
         """Handle evaluation run updates."""
         try:
             if payload.success:
-                # Store results for final display
                 self.eval_results_by_name[payload.eval_item.name] = payload.eval_results
                 self._display_successful_evaluation(
                     payload.eval_item.name, payload.eval_results
                 )
+                self._display_logs_panel(payload.eval_item.name, payload.logs)
             else:
-                error_msg = self._extract_error_message(payload.eval_item)
-                self._display_failed_evaluation(payload.eval_item.name, error_msg)
-
-            logs = payload.logs
-
-            self.console.print(
-                Rule(
-                    f"[dim italic]Execution Logs: {payload.eval_item.name}[/dim italic]",
-                    style="dim",
-                    align="center",
-                )
-            )
-
-            if len(logs) > 0:
-                for record in logs:
-                    log_line = f"  [dim]{record.getMessage()}[/dim]"
-                    self.console.print(log_line)
-            else:
-                self.console.print("  [dim italic]No execution logs[/dim italic]")
-
-            self.console.print(Rule(style="dim"))
+                error_msg = self._extract_error_message(payload)
+                self._display_failed_evaluation(payload.eval_item.name)
+
+                if payload.exception_details.runtime_exception:  # type: ignore
+                    self._display_logs_panel(
+                        payload.eval_item.name, payload.logs, error_msg
+                    )
+                else:
+                    self.console.print(f"  [red]{error_msg}[/red]")
+                    self.console.print()
         except Exception as e:
             logger.error(f"Console reporter error: {e}")
 

uipath-2.1.76/src/uipath/_cli/_evals/_models/_exceptions.py

@@ -0,0 +1,5 @@
+class EvaluationRuntimeException(Exception):
+    def __init__(self, spans, logs, root_exception):
+        self.spans = spans
+        self.logs = logs
+        self.root_exception = root_exception

{uipath-2.1.75 → uipath-2.1.76}/src/uipath/_cli/_evals/_runtime.py

@@ -11,6 +11,7 @@ from opentelemetry.sdk.trace.export import SpanExporter, SpanExportResult
 
 from ..._events._event_bus import EventBus
 from ..._events._events import (
+    EvalItemExceptionDetails,
     EvalRunCreatedEvent,
     EvalRunUpdatedEvent,
     EvalSetRunCreatedEvent,
@@ -31,6 +32,7 @@ from .._runtime._logging import ExecutionLogHandler
 from .._utils._eval_set import EvalHelpers
 from ._evaluator_factory import EvaluatorFactory
 from ._models._evaluation_set import EvaluationItem, EvaluationSet
+from ._models._exceptions import EvaluationRuntimeException
 from ._models._output import (
     EvaluationResultDto,
     EvaluationRunResult,
@@ -232,8 +234,7 @@ class UiPathEvalRuntime(UiPathBaseRuntime, Generic[T, C]):
                     wait_for_completion=False,
                 )
             except Exception as e:
-                error_msg = str(e)
-                eval_item._error_message = error_msg  # type: ignore[attr-defined]
+                exception_details = EvalItemExceptionDetails(exception=e)
 
                 for evaluator in evaluators:
                     evaluator_counts[evaluator.id] += 1
@@ -242,18 +243,28 @@ class UiPathEvalRuntime(UiPathBaseRuntime, Generic[T, C]):
                         0.0 - evaluator_averages[evaluator.id]
                     ) / count
 
+                eval_run_updated_event = EvalRunUpdatedEvent(
+                    execution_id=self.execution_id,
+                    eval_item=eval_item,
+                    eval_results=[],
+                    success=False,
+                    agent_output={},
+                    agent_execution_time=0.0,
+                    exception_details=exception_details,
+                    spans=[],
+                    logs=[],
+                )
+                if isinstance(e, EvaluationRuntimeException):
+                    eval_run_updated_event.spans = e.spans
+                    eval_run_updated_event.logs = e.logs
+                    eval_run_updated_event.exception_details.exception = (  # type: ignore
+                        e.root_exception
+                    )
+                    eval_run_updated_event.exception_details.runtime_exception = True  # type: ignore
+
                 await event_bus.publish(
                     EvaluationEvents.UPDATE_EVAL_RUN,
-                    EvalRunUpdatedEvent(
-                        execution_id=self.execution_id,
-                        eval_item=eval_item,
-                        eval_results=[],
-                        success=False,
-                        agent_output={},
-                        agent_execution_time=0.0,
-                        spans=[],
-                        logs=[],
-                    ),
+                    eval_run_updated_event,
                     wait_for_completion=False,
                 )
 
@@ -274,6 +285,17 @@ class UiPathEvalRuntime(UiPathBaseRuntime, Generic[T, C]):
         )
         return self.context.result
 
+    def _get_and_clear_execution_data(
+        self, execution_id: str
+    ) -> tuple[List[ReadableSpan], list[logging.LogRecord]]:
+        spans = self.span_exporter.get_spans(execution_id)
+        self.span_exporter.clear(execution_id)
+
+        logs = self.logs_exporter.get_logs(execution_id)
+        self.logs_exporter.clear(execution_id)
+
+        return spans, logs
+
     async def execute_runtime(
         self, eval_item: EvaluationItem
     ) -> UiPathEvalRunExecutionOutput:
@@ -284,6 +306,9 @@ class UiPathEvalRuntime(UiPathBaseRuntime, Generic[T, C]):
             is_eval_run=True,
             log_handler=self._setup_execution_logging(eval_item_id),
         )
+        if runtime_context.execution_id is None:
+            raise ValueError("execution_id must be set for eval runs")
+
         attributes = {
             "evalId": eval_item.id,
             "span_type": "eval",
@@ -292,21 +317,22 @@ class UiPathEvalRuntime(UiPathBaseRuntime, Generic[T, C]):
             attributes["execution.id"] = runtime_context.execution_id
 
         start_time = time()
-
-        result = await self.factory.execute_in_root_span(
-            runtime_context, root_span=eval_item.name, attributes=attributes
-        )
+        try:
+            result = await self.factory.execute_in_root_span(
+                runtime_context, root_span=eval_item.name, attributes=attributes
+            )
+        except Exception as e:
+            spans, logs = self._get_and_clear_execution_data(
+                runtime_context.execution_id
+            )
+            raise EvaluationRuntimeException(
+                spans=spans,
+                logs=logs,
+                root_exception=e,
+            ) from e
 
         end_time = time()
-
-        if runtime_context.execution_id is None:
-            raise ValueError("execution_id must be set for eval runs")
-
-        spans = self.span_exporter.get_spans(runtime_context.execution_id)
-        self.span_exporter.clear(runtime_context.execution_id)
-
-        logs = self.logs_exporter.get_logs(runtime_context.execution_id)
-        self.logs_exporter.clear(runtime_context.execution_id)
+        spans, logs = self._get_and_clear_execution_data(runtime_context.execution_id)
 
         if result is None:
             raise ValueError("Execution result cannot be None for eval runs")

{uipath-2.1.75 → uipath-2.1.76}/src/uipath/_cli/cli_eval.py

@@ -17,6 +17,7 @@ from uipath._cli._runtime._contracts import (
     UiPathRuntimeFactory,
 )
 from uipath._cli._runtime._runtime import UiPathScriptRuntime
+from uipath._cli._utils._constants import UIPATH_PROJECT_ID
 from uipath._cli._utils._folders import get_personal_workspace_key_async
 from uipath._cli.middlewares import Middlewares
 from uipath._events._event_bus import EventBus
@@ -39,6 +40,22 @@ class LiteralOption(click.Option):
             raise click.BadParameter(value) from e
 
 
+def setup_reporting_prereq(no_report: bool) -> bool:
+    if no_report:
+        return False
+
+    if not os.getenv(UIPATH_PROJECT_ID, False):
+        console.warning(
+            "UIPATH_PROJECT_ID environment variable not set. Results will no be reported to Studio Web."
+        )
+        return False
+    if not os.getenv("UIPATH_FOLDER_KEY"):
+        os.environ["UIPATH_FOLDER_KEY"] = asyncio.run(
+            get_personal_workspace_key_async()
+        )
+    return True
+
+
 @click.command()
 @click.argument("entrypoint", required=False)
 @click.argument("eval_set", required=False)
@@ -79,10 +96,7 @@ def eval(
         workers: Number of parallel workers for running evaluations
         no_report: Do not report the evaluation results
     """
-    if not no_report and not os.getenv("UIPATH_FOLDER_KEY"):
-        os.environ["UIPATH_FOLDER_KEY"] = asyncio.run(
-            get_personal_workspace_key_async()
-        )
+    should_register_progress_reporter = setup_reporting_prereq(no_report)
 
     result = Middlewares.next(
         "eval",
@@ -92,6 +106,7 @@ def eval(
         no_report=no_report,
         workers=workers,
         execution_output_file=output_file,
+        register_progress_reporter=should_register_progress_reporter,
     )
 
     if result.error_message:
@@ -100,7 +115,7 @@ def eval(
     if result.should_continue:
         event_bus = EventBus()
 
-        if not no_report:
+        if should_register_progress_reporter:
             progress_reporter = StudioWebProgressReporter(LlmOpsHttpExporter())
             asyncio.run(progress_reporter.subscribe_to_eval_runtime_events(event_bus))
 

{uipath-2.1.75 → uipath-2.1.76}/src/uipath/_events/_events.py

@@ -1,9 +1,9 @@
 import enum
 import logging
-from typing import Any, List, Union
+from typing import Any, List, Optional, Union
 
 from opentelemetry.sdk.trace import ReadableSpan
-from pydantic import BaseModel, ConfigDict
+from pydantic import BaseModel, ConfigDict, model_validator
 
 from uipath._cli._evals._models._evaluation_set import EvaluationItem
 from uipath.eval.models import EvalItemResult
@@ -29,6 +29,13 @@ class EvalRunCreatedEvent(BaseModel):
     eval_item: EvaluationItem
 
 
+class EvalItemExceptionDetails(BaseModel):
+    model_config = ConfigDict(arbitrary_types_allowed=True)
+
+    runtime_exception: bool = False
+    exception: Exception
+
+
 class EvalRunUpdatedEvent(BaseModel):
     model_config = ConfigDict(arbitrary_types_allowed=True)
 
@@ -40,6 +47,13 @@ class EvalRunUpdatedEvent(BaseModel):
     agent_execution_time: float
     spans: List[ReadableSpan]
     logs: List[logging.LogRecord]
+    exception_details: Optional[EvalItemExceptionDetails] = None
+
+    @model_validator(mode="after")
+    def validate_exception_details(self):
+        if not self.success and self.exception_details is None:
+            raise ValueError("exception_details must be provided when success is False")
+        return self
 
 
 class EvalSetRunUpdatedEvent(BaseModel):