uipath 2.1.97__py3-none-any.whl → 2.1.99__py3-none-any.whl

uipath/_cli/__init__.py

@@ -3,6 +3,7 @@ import sys
 
 import click
 
+from .._utils._logs import setup_logging
 from ._utils._common import add_cwd_to_path, load_environment_variables
 from .cli_auth import auth as auth
 from .cli_debug import debug as debug  # type: ignore
@@ -47,6 +48,7 @@ def _get_safe_version() -> str:
 def cli(lv: bool, v: bool) -> None:
     load_environment_variables()
     add_cwd_to_path()
+    setup_logging()
     if lv:
         try:
             version = importlib.metadata.version("uipath-langchain")

uipath/_cli/_debug/_bridge.py

@@ -5,9 +5,11 @@ import os
 from abc import ABC, abstractmethod
 from typing import Any, Dict, Optional
 
+from pydantic import BaseModel
 from pysignalr.client import SignalRClient
 from rich.console import Console
 from rich.syntax import Syntax
+from rich.tree import Tree
 
 from uipath._cli._runtime._contracts import (
     UiPathBreakpointResult,
@@ -115,7 +117,7 @@ class ConsoleDebugBridge(UiPathDebugBridge):
 
         self.console.print(f"[yellow]●[/yellow] [bold]{state_event.node_name}[/bold]")
         if state_event.payload:
-            self._print_json(state_event.payload, label="State")
+            self._print_json(state_event.payload, label="state")
 
     async def emit_breakpoint_hit(
         self, breakpoint_result: UiPathBreakpointResult
@@ -135,7 +137,7 @@ class ConsoleDebugBridge(UiPathDebugBridge):
 
         # Display current state
         if breakpoint_result.current_state:
-            self._print_json(breakpoint_result.current_state, label="State")
+            self._print_json(breakpoint_result.current_state, label="state")
 
     async def emit_execution_completed(
         self,
@@ -157,7 +159,7 @@ class ConsoleDebugBridge(UiPathDebugBridge):
 
         self.console.print(f"[{color}]{symbol} END[/{color}]")
         if runtime_result.output:
-            self._print_json(runtime_result.output, label="Output")
+            self._print_json(runtime_result.output, label="output")
 
     async def emit_execution_error(
         self,
@@ -193,36 +195,83 @@ class ConsoleDebugBridge(UiPathDebugBridge):
         self.console.print()
         return user_input
 
-    def _print_json(self, data: Dict[str, Any], label: str = "Data") -> None:
-        """Print JSON data in a readable format."""
+    def _print_json(self, data: Dict[str, Any], label: str = "data") -> None:
+        """Print JSON data with enhanced hierarchy."""
         try:
-            json_str = json.dumps(data, indent=2, default=str)
-
-            # Limit output if too large
-            is_truncated = False
-            if len(json_str) > 2000:
-                json_str = json_str[:2000] + "\n..."
-                is_truncated = True
-
-            syntax = Syntax(
-                json_str,
-                "json",
-                theme="monokai",
-                line_numbers=False,
-                background_color="default",
-            )
+            # Create a tree for nested structure
+            tree = Tree(f"[bold cyan]{label}[/bold cyan]")
+
+            def process_value(
+                node: Tree, value: Any, key_label: str, depth: int
+            ) -> None:
+                """Process a single value and add it to the tree."""
+                if isinstance(value, BaseModel):
+                    branch = node.add(
+                        f"{key_label} [dim]({type(value).__name__})[/dim]"
+                    )
+                    add_to_tree(branch, value, depth + 1)
+                elif isinstance(value, dict):
+                    branch = node.add(f"{key_label} [dim](dict)[/dim]")
+                    add_to_tree(branch, value, depth + 1)
+                elif isinstance(value, list):
+                    branch = node.add(
+                        f"{key_label} [dim](list, {len(value)} items)[/dim]"
+                    )
+                    add_to_tree(branch, value, depth + 1)
+                else:
+                    val_str = str(value)
+                    if len(val_str) > 250:
+                        val_str = val_str[:250] + "..."
+                    node.add(f"{key_label}: [green]{val_str}[/green]")
+
+            def add_to_tree(node: Tree, payload: Any, depth: int = 0):
+                if depth > 10:
+                    node.add("[dim]...[/dim]")
+                    return
+
+                if isinstance(payload, BaseModel):
+                    try:
+                        payload = payload.model_dump()  # Pydantic v2
+                    except AttributeError:
+                        payload = payload.dict()  # Pydantic v1
+                    add_to_tree(node, payload, depth)
+
+                elif isinstance(payload, dict):
+                    for key, value in payload.items():
+                        process_value(node, value, f"[yellow]{key}[/yellow]", depth)
+
+                elif isinstance(payload, list):
+                    for i, item in enumerate(payload):
+                        process_value(node, item, f"[cyan]#{i}[/cyan]", depth)
+
+                else:
+                    val_str = str(payload)
+                    if len(val_str) > 250:
+                        val_str = val_str[:250] + "..."
+                    node.add(f"[green]{val_str}[/green]")
+
+            add_to_tree(tree, data)
 
             self.console.print()
-            truncated_text = " (truncated)" if is_truncated else ""
-            self.console.print(f"[dim]{label}{truncated_text}:")
-            self.console.print(syntax)
+            self.console.print(tree)
             self.console.print()
+
         except Exception:
-            # Fallback to simple print
-            self.console.print()
-            self.console.print(f"[dim]{label}:")
-            self.console.print(str(data))
-            self.console.print()
+            try:
+                json_str = json.dumps(data, indent=2, default=str)
+                if len(json_str) > 10000:
+                    json_str = json_str[:10000] + "\n..."
+
+                syntax = Syntax(json_str, "json", theme="monokai", line_numbers=False)
+                self.console.print(f"\n[dim]{label}:")
+                self.console.print(syntax)
+                self.console.print()
+            except Exception:
+                # Fallback to simple print
+                self.console.print()
+                self.console.print(f"[dim]{label}:")
+                self.console.print(str(data))
+                self.console.print()
 
 
 class SignalRDebugBridge(UiPathDebugBridge):

uipath/_cli/_debug/_runtime.py

@@ -56,7 +56,7 @@ class UiPathDebugRuntime(UiPathBaseRuntime, Generic[T, C]):
                 raise RuntimeError("Failed to create inner runtime")
 
             await self.debug_bridge.emit_execution_started(
-                execution_id=self.context.execution_id or "default"
+                execution_id=self.context.job_id or "default"
             )
 
             # Try to stream events from inner runtime
@@ -78,7 +78,7 @@ class UiPathDebugRuntime(UiPathBaseRuntime, Generic[T, C]):
         except Exception as e:
             # Emit execution error
             await self.debug_bridge.emit_execution_error(
-                execution_id=self.context.execution_id or "default",
+                execution_id=self.context.job_id or "default",
                 error=str(e),
             )
             raise

uipath/_cli/_evals/_runtime.py

@@ -451,12 +451,12 @@ class UiPathEvalRuntime(UiPathBaseRuntime, Generic[T, C]):
     async def execute_runtime(
         self, eval_item: EvaluationItem, execution_id: str
     ) -> UiPathEvalRunExecutionOutput:
-        runtime_context: C = self.factory.new_context(
-            execution_id=execution_id,
-            input_json=eval_item.inputs,
-            is_eval_run=True,
-            log_handler=self._setup_execution_logging(execution_id),
-        )
+        context_args = self.context.model_dump()
+        context_args["execution_id"] = execution_id
+        context_args["input_json"] = eval_item.inputs
+        context_args["is_eval_run"] = True
+        context_args["log_handler"] = self._setup_execution_logging(execution_id)
+        runtime_context: C = self.factory.new_context(**context_args)
         if runtime_context.execution_id is None:
             raise ValueError("execution_id must be set for eval runs")
 

uipath/_cli/_runtime/_contracts.py

@@ -39,6 +39,7 @@ from uipath._events._events import UiPathRuntimeEvent
 from uipath.agent.conversation import UiPathConversationEvent, UiPathConversationMessage
 from uipath.tracing import TracingManager
 
+from ..models.runtime_schema import BindingResource, Entrypoint
 from ._logging import LogsInterceptor
 
 logger = logging.getLogger(__name__)
@@ -516,6 +517,22 @@ class UiPathBaseRuntime(ABC):
         runtime = cls(context)
         return runtime
 
+    @property
+    def get_binding_resources(self) -> List[BindingResource]:
+        """Get binding resources for this runtime.
+
+        Returns: A list of binding resources.
+        """
+        raise NotImplementedError()
+
+    @property
+    def get_entrypoint(self) -> Entrypoint:
+        """Get entrypoint for this runtime.
+
+        Returns: A entrypoint for this runtime.
+        """
+        raise NotImplementedError()
+
     async def __aenter__(self):
         """Async enter method called when entering the 'async with' block.
 
@@ -806,9 +823,9 @@ class UiPathRuntimeFactory(Generic[T, C]):
             return self.context_generator(**kwargs)
         return self.context_class(**kwargs)
 
-    def new_runtime(self) -> T:
+    def new_runtime(self, **kwargs) -> T:
         """Create a new runtime instance."""
-        context = self.new_context()
+        context = self.new_context(**kwargs)
         if self.runtime_generator:
             return self.runtime_generator(context)
         return self.runtime_class.from_context(context)

uipath/_cli/_runtime/_runtime.py

@@ -1,8 +1,18 @@
 """Python script runtime implementation for executing and managing python scripts."""
 
 import logging
-from typing import Any, Awaitable, Callable, Optional, TypeVar
-
+import os
+import uuid
+from functools import cached_property
+from pathlib import Path
+from typing import Any, Awaitable, Callable, List, Optional, TypeVar
+
+from typing_extensions import override
+
+from .._utils._console import ConsoleLogger
+from .._utils._input_args import generate_args
+from .._utils._parse_ast import generate_bindings  # type: ignore[attr-defined]
+from ..models.runtime_schema import BindingResource, Entrypoint
 from ._contracts import (
     UiPathBaseRuntime,
     UiPathErrorCategory,
@@ -63,6 +73,36 @@ class UiPathRuntime(UiPathBaseRuntime):
             ) from e
 
 
+console = ConsoleLogger()
+
+
+def get_user_script(directory: str, entrypoint: Optional[str] = None) -> Optional[str]:
+    """Find the Python script to process."""
+    if entrypoint:
+        script_path = os.path.join(directory, entrypoint)
+        if not os.path.isfile(script_path):
+            console.error(
+                f"The {entrypoint} file does not exist in the current directory."
+            )
+            return None
+        return script_path
+
+    python_files = [f for f in os.listdir(directory) if f.endswith(".py")]
+
+    if not python_files:
+        console.error(
+            "No python files found in the current directory.\nPlease specify the entrypoint: `uipath init <entrypoint_path>`"
+        )
+        return None
+    elif len(python_files) == 1:
+        return os.path.join(directory, python_files[0])
+    else:
+        console.error(
+            "Multiple python files found in the current directory.\nPlease specify the entrypoint: `uipath init <entrypoint_path>`"
+        )
+        return None
+
+
 class UiPathScriptRuntime(UiPathRuntime):
     """Runtime for executing Python scripts."""
 
@@ -74,3 +114,32 @@ class UiPathScriptRuntime(UiPathRuntime):
     def from_context(cls, context: UiPathRuntimeContext):
         """Create runtime instance from context."""
         return UiPathScriptRuntime(context, context.entrypoint or "")
+
+    @cached_property
+    @override
+    def get_binding_resources(self) -> List[BindingResource]:
+        """Get binding resources for script runtime.
+
+        Returns: A list of binding resources.
+        """
+        working_dir = self.context.runtime_dir or os.getcwd()
+        script_path = get_user_script(working_dir, entrypoint=self.context.entrypoint)
+        bindings = generate_bindings(script_path)
+        return bindings.resources
+
+    @cached_property
+    @override
+    def get_entrypoint(self) -> Entrypoint:
+        working_dir = self.context.runtime_dir or os.getcwd()
+        script_path = get_user_script(working_dir, entrypoint=self.context.entrypoint)
+        if not script_path:
+            raise ValueError("Entrypoint not found.")
+        relative_path = Path(script_path).relative_to(working_dir).as_posix()
+        args = generate_args(script_path)
+        return Entrypoint(
+            file_path=relative_path,  # type: ignore[call-arg] # This exists
+            unique_id=str(uuid.uuid4()),
+            type="agent",
+            input=args["input"],
+            output=args["output"],
+        )

uipath/_cli/_runtime/_runtime_factory.py

@@ -0,0 +1,21 @@
+from uipath._cli._runtime._contracts import (
+    UiPathBaseRuntime,
+    UiPathRuntimeContext,
+    UiPathRuntimeFactory,
+)
+from uipath._cli._runtime._runtime import UiPathScriptRuntime
+
+
+def generate_runtime_factory() -> UiPathRuntimeFactory[
+    UiPathBaseRuntime, UiPathRuntimeContext
+]:
+    runtime_factory: UiPathRuntimeFactory[UiPathBaseRuntime, UiPathRuntimeContext] = (
+        UiPathRuntimeFactory(
+            UiPathScriptRuntime,
+            UiPathRuntimeContext,
+            context_generator=lambda **kwargs: UiPathRuntimeContext.with_defaults(
+                **kwargs
+            ),
+        )
+    )
+    return runtime_factory

uipath/_cli/cli_debug.py

@@ -1,7 +1,6 @@
 # type: ignore
 import asyncio
 import os
-import uuid
 from os import environ as env
 from typing import Optional
 
@@ -110,7 +109,6 @@ def debug(
                 execution_output_file=output_file,
                 debug=debug,
             )
-            debug_context.execution_id = debug_context.job_id or str(uuid.uuid4())
 
             runtime_factory = UiPathRuntimeFactory(
                 UiPathScriptRuntime,

uipath/_cli/cli_eval.py

@@ -12,11 +12,7 @@ from uipath._cli._evals._runtime import (
     UiPathEvalContext,
     UiPathEvalRuntime,
 )
-from uipath._cli._runtime._contracts import (
-    UiPathRuntimeContext,
-    UiPathRuntimeFactory,
-)
-from uipath._cli._runtime._runtime import UiPathScriptRuntime
+from uipath._cli._runtime._runtime_factory import generate_runtime_factory
 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
@@ -96,6 +92,15 @@ def eval(
         workers: Number of parallel workers for running evaluations
         no_report: Do not report the evaluation results
     """
+    context_args = {
+        "entrypoint": entrypoint or auto_discover_entrypoint(),
+        "eval_set": eval_set,
+        "eval_ids": eval_ids,
+        "workers": workers,
+        "no_report": no_report,
+        "output_file": output_file,
+    }
+
     should_register_progress_reporter = setup_reporting_prereq(no_report)
 
     result = Middlewares.next(
@@ -119,16 +124,9 @@ def eval(
             progress_reporter = StudioWebProgressReporter(LlmOpsHttpExporter())
             asyncio.run(progress_reporter.subscribe_to_eval_runtime_events(event_bus))
 
-        def generate_runtime_context(**context_kwargs) -> UiPathRuntimeContext:
-            runtime_context = UiPathRuntimeContext.with_defaults(**context_kwargs)
-            runtime_context.entrypoint = runtime_entrypoint
-            return runtime_context
-
-        runtime_entrypoint = entrypoint or auto_discover_entrypoint()
-
         eval_context = UiPathEvalContext.with_defaults(
             execution_output_file=output_file,
-            entrypoint=runtime_entrypoint,
+            entrypoint=context_args["entrypoint"],
         )
 
         eval_context.no_report = no_report
@@ -140,11 +138,7 @@ def eval(
         asyncio.run(console_reporter.subscribe_to_eval_runtime_events(event_bus))
 
         try:
-            runtime_factory = UiPathRuntimeFactory(
-                UiPathScriptRuntime,
-                UiPathRuntimeContext,
-                context_generator=generate_runtime_context,
-            )
+            runtime_factory = generate_runtime_factory()
             if eval_context.job_id:
                 runtime_factory.add_span_exporter(LlmOpsHttpExporter())
 

uipath/_cli/cli_init.py

@@ -5,7 +5,6 @@ import logging
 import os
 import shutil
 import uuid
-from pathlib import Path
 from typing import Any, Dict, Optional
 
 import click
@@ -13,11 +12,11 @@ import click
 from .._utils.constants import ENV_TELEMETRY_ENABLED
 from ..telemetry import track
 from ..telemetry._constants import _PROJECT_KEY, _TELEMETRY_CONFIG_FILE
+from ._runtime._runtime import get_user_script
+from ._runtime._runtime_factory import generate_runtime_factory
 from ._utils._console import ConsoleLogger
-from ._utils._input_args import generate_args
-from ._utils._parse_ast import generate_bindings
 from .middlewares import Middlewares
-from .models.runtime_schema import Bindings, Entrypoint, RuntimeSchema
+from .models.runtime_schema import Bindings, RuntimeSchema
 
 console = ConsoleLogger()
 logger = logging.getLogger(__name__)
@@ -61,18 +60,25 @@ def generate_env_file(target_directory):
         console.success(f"Created '{relative_path}' file.")
 
 
-def generate_agent_md_file(target_directory: str, file_name: str) -> None:
+def generate_agent_md_file(
+    target_directory: str, file_name: str, no_agents_md_override: bool
+) -> bool:
     """Generate an agent-specific file from the packaged resource.
 
     Args:
         target_directory: The directory where the file should be created.
         file_name: The name of the file should be created.
+        no_agents_md_override: Whether to override existing files.
     """
     target_path = os.path.join(target_directory, file_name)
 
-    if os.path.exists(target_path):
-        logger.debug(f"File '{target_path}' already exists.")
-        return
+    will_override = os.path.exists(target_path)
+
+    if will_override and no_agents_md_override:
+        console.success(
+            f"File {click.style(target_path, fg='cyan')} already exists. Skipping."
+        )
+        return False
 
     try:
         source_path = importlib.resources.files("uipath._resources").joinpath(file_name)
@@ -80,15 +86,23 @@ def generate_agent_md_file(target_directory: str, file_name: str) -> None:
         with importlib.resources.as_file(source_path) as s_path:
             shutil.copy(s_path, target_path)
 
+        if will_override:
+            logger.debug(f"File '{target_path}' has been overridden.")
+
+        return will_override
+
     except Exception as e:
         console.warning(f"Could not create {file_name}: {e}")
 
+    return False
+
 
-def generate_agent_md_files(target_directory: str) -> None:
+def generate_agent_md_files(target_directory: str, no_agents_md_override: bool) -> None:
     """Generate an agent-specific file from the packaged resource.
 
     Args:
         target_directory: The directory where the files should be created.
+        no_agents_md_override: Whether to override existing files.
     """
     agent_dir = os.path.join(target_directory, ".agent")
     os.makedirs(agent_dir, exist_ok=True)
@@ -97,13 +111,21 @@ def generate_agent_md_files(target_directory: str) -> None:
 
     agent_files = ["CLI_REFERENCE.md", "REQUIRED_STRUCTURE.md", "SDK_REFERENCE.md"]
 
+    any_overridden = False
+
     for file_name in root_files:
-        generate_agent_md_file(target_directory, file_name)
+        if generate_agent_md_file(target_directory, file_name, no_agents_md_override):
+            any_overridden = True
 
     for file_name in agent_files:
-        generate_agent_md_file(agent_dir, file_name)
+        if generate_agent_md_file(agent_dir, file_name, no_agents_md_override):
+            any_overridden = True
 
-    console.success(f"Created {click.style('AGENTS.md', fg='cyan')} file.")
+    if any_overridden:
+        console.success(f"Updated {click.style('AGENTS.md', fg='cyan')} related files.")
+        return
+
+    console.success(f"Created {click.style('AGENTS.md', fg='cyan')} related files.")
 
 
 def get_existing_settings(config_path: str) -> Optional[Dict[str, Any]]:
@@ -126,33 +148,6 @@ def get_existing_settings(config_path: str) -> Optional[Dict[str, Any]]:
         return None
 
 
-def get_user_script(directory: str, entrypoint: Optional[str] = None) -> Optional[str]:
-    """Find the Python script to process."""
-    if entrypoint:
-        script_path = os.path.join(directory, entrypoint)
-        if not os.path.isfile(script_path):
-            console.error(
-                f"The {entrypoint} file does not exist in the current directory."
-            )
-            return None
-        return script_path
-
-    python_files = [f for f in os.listdir(directory) if f.endswith(".py")]
-
-    if not python_files:
-        console.error(
-            "No python files found in the current directory.\nPlease specify the entrypoint: `uipath init <entrypoint_path>`"
-        )
-        return None
-    elif len(python_files) == 1:
-        return os.path.join(directory, python_files[0])
-    else:
-        console.error(
-            "Multiple python files found in the current directory.\nPlease specify the entrypoint: `uipath init <entrypoint_path>`"
-        )
-        return None
-
-
 def write_config_file(config_data: Dict[str, Any] | RuntimeSchema) -> None:
     existing_settings = get_existing_settings(CONFIG_PATH)
     if existing_settings is not None:
@@ -177,8 +172,15 @@ def write_config_file(config_data: Dict[str, Any] | RuntimeSchema) -> None:
     default=True,
     help="Infer bindings from the script.",
 )
+@click.option(
+    "--no-agents-md-override",
+    is_flag=True,
+    required=False,
+    default=False,
+    help="Won't override existing .agent files and AGENTS.md file.",
+)
 @track
-def init(entrypoint: str, infer_bindings: bool) -> None:
+def init(entrypoint: str, infer_bindings: bool, no_agents_md_override: bool) -> None:
     """Create uipath.json with input/output schemas and bindings."""
     with console.spinner("Initializing UiPath project ..."):
         current_directory = os.getcwd()
@@ -203,41 +205,30 @@ def init(entrypoint: str, infer_bindings: bool) -> None:
         if not result.should_continue:
             return
 
-        generate_agent_md_files(current_directory)
+        generate_agent_md_files(current_directory, no_agents_md_override)
         script_path = get_user_script(current_directory, entrypoint=entrypoint)
-
         if not script_path:
             return
 
-        try:
-            args = generate_args(script_path)
-
-            relative_path = Path(script_path).relative_to(current_directory).as_posix()
-            bindings = None
-            if infer_bindings:
-                try:
-                    bindings = generate_bindings(script_path)
-                except Exception as e:
-                    console.warning(f"Warning: Could not generate bindings: {str(e)}")
-            if bindings is None:
+        context_args = {
+            "runtime_dir": os.getcwd(),
+            "entrypoint": script_path,
+        }
+
+        def initialize() -> None:
+            try:
+                runtime = generate_runtime_factory().new_runtime(**context_args)
                 bindings = Bindings(
                     version="2.0",
-                    resources=[],
+                    resources=runtime.get_binding_resources,
                 )
-            config_data = RuntimeSchema(
-                entrypoints=[
-                    Entrypoint(
-                        file_path=relative_path,
-                        unique_id=str(uuid.uuid4()),
-                        type="agent",
-                        input=args["input"],
-                        output=args["output"],
-                    )
-                ],
-                bindings=bindings,
-            )
+                config_data = RuntimeSchema(
+                    entryPoints=[runtime.get_entrypoint],
+                    bindings=bindings,
+                )
+                config_path = write_config_file(config_data)
+                console.success(f"Created '{config_path}' file.")
+            except Exception as e:
+                console.error(f"Error creating configuration file:\n {str(e)}")
 
-            config_path = write_config_file(config_data)
-            console.success(f"Created '{config_path}' file.")
-        except Exception as e:
-            console.error(f"Error creating configuration file:\n {str(e)}")
+        initialize()

uipath/_cli/cli_run.py

@@ -6,6 +6,7 @@ from typing import Optional
 
 import click
 
+from uipath._cli._runtime._runtime_factory import generate_runtime_factory
 from uipath._cli._utils._debug import setup_debugging
 from uipath.tracing import LlmOpsHttpExporter
 
@@ -13,12 +14,7 @@ from .._utils.constants import (
     ENV_JOB_ID,
 )
 from ..telemetry import track
-from ._runtime._contracts import (
-    UiPathRuntimeContext,
-    UiPathRuntimeError,
-    UiPathRuntimeFactory,
-)
-from ._runtime._runtime import UiPathScriptRuntime
+from ._runtime._contracts import UiPathRuntimeError
 from ._utils._console import ConsoleLogger
 from .middlewares import Middlewares
 
@@ -71,6 +67,14 @@ def run(
     debug_port: int,
 ) -> None:
     """Execute the project."""
+    context_args = {
+        "entrypoint": entrypoint,
+        "input": input,
+        "resume": resume,
+        "input_file": file or input_file,
+        "execution_output_file": output_file,
+        "debug": debug,
+    }
     input_file = file or input_file
     # Setup debugging if requested
     if not setup_debugging(debug, debug_port):
@@ -100,27 +104,17 @@ def run(
     Usage: `uipath run <entrypoint_path> <input_arguments> [-f <input_json_file_path>]`""")
 
         try:
-            runtime_factory = UiPathRuntimeFactory(
-                UiPathScriptRuntime, UiPathRuntimeContext
-            )
-
-            context = UiPathRuntimeContext.with_defaults(
-                entrypoint=entrypoint,
-                input=input,
-                input_file=input_file,
-                resume=resume,
-                execution_output_file=output_file,
-                debug=debug,
-            )
-            if context.job_id:
-                runtime_factory.add_span_exporter(LlmOpsHttpExporter())
 
-            async def execute_runtime():
+            async def execute() -> None:
+                runtime_factory = generate_runtime_factory()
+                context = runtime_factory.new_context(**context_args)
+                if context.job_id:
+                    runtime_factory.add_span_exporter(LlmOpsHttpExporter())
                 result = await runtime_factory.execute(context)
                 if not context.job_id:
                     console.info(result.output)
 
-            asyncio.run(execute_runtime())
+            asyncio.run(execute())
 
         except UiPathRuntimeError as e:
             console.error(f"{e.error_info.title} - {e.error_info.detail}")

uipath/_resources/CLI_REFERENCE.md

@@ -27,6 +27,7 @@ The UiPath Python SDK provides a comprehensive CLI for managing coded agents and
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
 | `--infer-bindings` | flag | false | Infer bindings from the script. |
+| `--no-agents-md-override` | flag | false | Won't override existing .agent files and AGENTS.md file. |
 
 **Usage Examples:**
 

uipath/_services/documents_service.py

@@ -27,6 +27,10 @@ class DocumentsService(FolderContext, BaseService):
     """Service for managing UiPath DocumentUnderstanding Document Operations.
 
     This service provides methods to extract data from documents using UiPath's Document Understanding capabilities.
+
+    !!! warning "Preview Feature"
+        This function is currently experimental.
+        Behavior and parameters are subject to change in future versions.
     """
 
     def __init__(self, config: Config, execution_context: ExecutionContext) -> None:

uipath/_uipath.py

@@ -21,7 +21,6 @@ from ._services import (
     UiPathLlmChatService,
     UiPathOpenAIService,
 )
-from ._utils import setup_logging
 from ._utils._auth import resolve_config
 from .models.errors import BaseUrlMissingError, SecretMissingError
 
@@ -56,7 +55,6 @@ class UiPath:
         self._attachments_service: Optional[AttachmentsService] = None
         self._connections_service: Optional[ConnectionsService] = None
 
-        setup_logging(debug)
         self._execution_context = ExecutionContext()
 
     @property

uipath/_utils/_logs.py

@@ -11,5 +11,4 @@ def setup_logging(should_debug: Optional[bool] = None) -> None:
         datefmt="%Y-%m-%d %H:%M:%S",
     )
     logger.setLevel(logging.DEBUG if should_debug else logging.INFO)
-    logger.removeHandler(logging.StreamHandler(sys.stdout))
     logger.addHandler(logging.StreamHandler(sys.stderr))

uipath/models/job.py

@@ -15,7 +15,7 @@ class JobErrorInfo(BaseModel):
     title: Optional[str] = Field(default=None, alias="Title")
     detail: Optional[str] = Field(default=None, alias="Detail")
     category: Optional[str] = Field(default=None, alias="Category")
-    status: Optional[str] = Field(default=None, alias="Status")
+    status: Optional[int] = Field(default=None, alias="Status")
 
 
 class Job(BaseModel):

{uipath-2.1.97.dist-info → uipath-2.1.99.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: uipath
-Version: 2.1.97
+Version: 2.1.99
 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.97.dist-info → uipath-2.1.99.dist-info}/RECORD

@@ -2,23 +2,23 @@ uipath/__init__.py,sha256=IaeKItOOQXMa95avueJ3dAq-XcRHyZVNjcCGwlSB000,634
 uipath/_config.py,sha256=pi3qxPzDTxMEstj_XkGOgKJqD6RTHHv7vYv8sS_-d5Q,92
 uipath/_execution_context.py,sha256=Qo8VMUFgtiL-40KsZrvul5bGv1CRERle_fCw1ORCggY,2374
 uipath/_folder_context.py,sha256=D-bgxdwpwJP4b_QdVKcPODYh15kMDrOar2xNonmMSm4,1861
-uipath/_uipath.py,sha256=mhtdu36-A-2WhPGNFFrTmQWbE07Bn4IV_Vrqgf6kuVM,4900
+uipath/_uipath.py,sha256=4WSnEEoE24DPX-gJJ6FQB1fS9frEDrRV0CiGd8iaZQ0,4837
 uipath/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 uipath/_cli/README.md,sha256=GLtCfbeIKZKNnGTCsfSVqRQ27V1btT1i2bSAyW_xZl4,474
-uipath/_cli/__init__.py,sha256=RZtYzThMGEKEwmiUwwm6TUU5KxDpfTuez2qSFD78J8w,2345
+uipath/_cli/__init__.py,sha256=aGym-NX6_5psRTm_fcCCh98E83OtufnKuGdQjw-sG9Y,2406
 uipath/_cli/cli_auth.py,sha256=CzetSRqSUvMs02PtI4w5Vi_0fv_ETA307bB2vXalWzY,2628
-uipath/_cli/cli_debug.py,sha256=-0ZWMe3aKfVZSiZCe7U2K_Xpai1fKxZpaETu_7ewj2s,4163
+uipath/_cli/cli_debug.py,sha256=-s6Nmy0DnDyITjZAf6f71hZ1YDDt0Yl57XklEkuL0FU,4068
 uipath/_cli/cli_deploy.py,sha256=KPCmQ0c_NYD5JofSDao5r6QYxHshVCRxlWDVnQvlp5w,645
 uipath/_cli/cli_dev.py,sha256=nEfpjw1PZ72O6jmufYWVrueVwihFxDPOeJakdvNHdOA,2146
-uipath/_cli/cli_eval.py,sha256=oOMywGSUrHDQ1W_54ccbekzCeduPf-KHRyu_r0Dezd0,5444
-uipath/_cli/cli_init.py,sha256=2OE9uF4uCEwOVE_MiPJGjEK0bCnlIjsBqOBHwB98X4c,7831
+uipath/_cli/cli_eval.py,sha256=6evrUtaHnQ1NTEQKZKltgH7mpYOy6YP88L2LZcnnnfs,5139
+uipath/_cli/cli_init.py,sha256=kCwAHzrTrerptInGx8-eWbh3SdwYdFqlmIsKNPhhnjA,7392
 uipath/_cli/cli_invoke.py,sha256=m-te-EjhDpk_fhFDkt-yQFzmjEHGo5lQDGEQWxSXisQ,4395
 uipath/_cli/cli_new.py,sha256=9378NYUBc9j-qKVXV7oja-jahfJhXBg8zKVyaon7ctY,2102
 uipath/_cli/cli_pack.py,sha256=U5rXVbUnHFgdEsXyhkjmWza8dfob1wU9lyl4yrYnUss,11076
 uipath/_cli/cli_publish.py,sha256=DgyfcZjvfV05Ldy0Pk5y_Le_nT9JduEE_x-VpIc_Kq0,6471
 uipath/_cli/cli_pull.py,sha256=muX2gR-W-bSrNI3pIO0zbhZAP0VBOSsOY2-yrq8HgAw,2433
 uipath/_cli/cli_push.py,sha256=_JbjI45uJaobBDaz--NlzAXYJNwHX_XGLa8eC9wN-Cg,3166
-uipath/_cli/cli_run.py,sha256=dLEFu_sFOKeKN9juscFt-PKnTl4-mTF1PNP_44skG-0,3887
+uipath/_cli/cli_run.py,sha256=4XEvJQEcFafDLJHbgd94cuYxeioprNFe1qwL7JeAplg,3789
 uipath/_cli/middlewares.py,sha256=tb0c4sU1SCYi0PNs956Qmk24NDk0C0mBfVQmTcyORE0,5000
 uipath/_cli/spinner.py,sha256=bS-U_HA5yne11ejUERu7CQoXmWdabUD2bm62EfEdV8M,1107
 uipath/_cli/_auth/_auth_server.py,sha256=v_b8KNwn0tAv8jxpeKdllOVzl31q9AcdwpE_koAK_w4,7235
@@ -32,8 +32,8 @@ uipath/_cli/_auth/auth_config.json,sha256=o8J5BBFwiEtjZLHpJ_64lvnTeYeRIHaJ-Bhg0Q
 uipath/_cli/_auth/index.html,sha256=uGK0CDTP8Rys_p4O_Pbd2x4tz0frKNVcumjrXnal5Nc,22814
 uipath/_cli/_auth/localhost.crt,sha256=oGl9oLLOiouHubAt39B4zEfylFvKEtbtr_43SIliXJc,1226
 uipath/_cli/_auth/localhost.key,sha256=X31VYXD8scZtmGA837dGX5l6G-LXHLo5ItWJhZXaz3c,1679
-uipath/_cli/_debug/_bridge.py,sha256=ylswtTAXPR_ThQxmYIa9PeRC80F-UVbeWMhRDUlMhYI,13908
-uipath/_cli/_debug/_runtime.py,sha256=fwpxmBFAhhMjanBQaCQdI-YuvMC6vhS8SSS8pvw_PJw,4946
+uipath/_cli/_debug/_bridge.py,sha256=7_2IM4dhaYZ56dkNqPRQzdRojBDmDsJLa7zKs8KFZHg,16132
+uipath/_cli/_debug/_runtime.py,sha256=h4WRBJn46dorTVXNZ32KIqg_-Z0mcLq5BvXGXqHAT_o,4934
 uipath/_cli/_dev/_terminal/__init__.py,sha256=di_RiN9Mcp9wqyKRRqXag28vbSw8_78mCnQZNn9H-Ss,14027
 uipath/_cli/_dev/_terminal/_components/_chat.py,sha256=NLRoy49QScHiI-q0FGykkaU8ajv1d23fx7issSALcFA,4119
 uipath/_cli/_dev/_terminal/_components/_details.py,sha256=FbLYtJ56gqHV6CIrpzO_n9Sk_YNg4nzRKTSsbj-DBPQ,17257
@@ -49,7 +49,7 @@ uipath/_cli/_dev/_terminal/_utils/_logger.py,sha256=_ipTl_oAiMF9I7keGt2AAFAMz40D
 uipath/_cli/_evals/_console_progress_reporter.py,sha256=HgB6pdMyoS6YVwuI3EpM2LBcH3U69nrdaTyNgPG8ssg,9304
 uipath/_cli/_evals/_evaluator_factory.py,sha256=Gycv94VtGOpMir_Gba-UoiAyrSRfbSfe8_pTfjzcA9Q,3875
 uipath/_cli/_evals/_progress_reporter.py,sha256=kX7rNSa-QCLXIzK-vb9Jjf-XLEtucdeiQPgPlSkpp2U,16778
-uipath/_cli/_evals/_runtime.py,sha256=JABvs_EhgG6qqpAsJcC2uTDRZw9JgYOhFrpejFGy2vA,20655
+uipath/_cli/_evals/_runtime.py,sha256=9XwdDIN33LTbCTjSQvq1tWOrWn1Q42nTbuh-f7LFXEg,20761
 uipath/_cli/_evals/_span_collection.py,sha256=RoKoeDFG2XODdlgI27ionCjU7LLD_C0LJJ3gu0wab10,779
 uipath/_cli/_evals/_models/_evaluation_set.py,sha256=0I83I3HNu_BrgFz9miar2QTyXKb0dAaEpYMQrKUHP0U,4958
 uipath/_cli/_evals/_models/_evaluator.py,sha256=fuC3UOYwPD4d_wdynHeLSCzbu82golNAnnPnxC8Y4rk,3315
@@ -66,11 +66,12 @@ uipath/_cli/_evals/mocks/mocker_factory.py,sha256=V5QKSTtQxztTo4-fK1TyAaXw2Z3mHf
 uipath/_cli/_evals/mocks/mockito_mocker.py,sha256=AO2BmFwA6hz3Lte-STVr7aJDPvMCqKNKa4j2jeNZ_U4,2677
 uipath/_cli/_evals/mocks/mocks.py,sha256=HY0IaSqqO8hioBB3rp5XwAjSpQE4K5hoH6oJQ-sH72I,2207
 uipath/_cli/_push/sw_file_handler.py,sha256=voZVfJeJTqkvf5aFZvxAHQ_qa7dX_Cz7wRsfhLKL9Ag,17884
-uipath/_cli/_runtime/_contracts.py,sha256=-RrABpM3NVCa3GwSnJQh_SPdgtarrExDyT8X_f5SLcY,33813
+uipath/_cli/_runtime/_contracts.py,sha256=WqHEMBo5jM5a-yV-KD0FeOkei4M3qq-hQwza2hCe9Rk,34318
 uipath/_cli/_runtime/_escalation.py,sha256=x3vI98qsfRA-fL_tNkRVTFXioM5Gv2w0GFcXJJ5eQtg,7981
 uipath/_cli/_runtime/_hitl.py,sha256=VKbM021nVg1HEDnTfucSLJ0LsDn83CKyUtVzofS2qTU,11369
 uipath/_cli/_runtime/_logging.py,sha256=srjAi3Cy6g7b8WNHiYNjaZT4t40F3XRqquuoGd2kh4Y,14019
-uipath/_cli/_runtime/_runtime.py,sha256=Gs75gZMwohO4x_TDkw_XPH_zVmKM3qCHhUj0mI2Bna4,2209
+uipath/_cli/_runtime/_runtime.py,sha256=in0mS-G_MDT2KnPHzjZta57GFGMJwSwJkUh06uaIMTU,4721
+uipath/_cli/_runtime/_runtime_factory.py,sha256=8wbJeTTFQwCZ-Zm7tRec2YjBCJGhWdEwxl9yMkPwz6U,640
 uipath/_cli/_runtime/_script_executor.py,sha256=PjbmEbyCMofGH2F85b8RFsxdV3Tqw0kVqdWOOk2ZLlI,9687
 uipath/_cli/_templates/.psmdcp.template,sha256=C7pBJPt98ovEljcBvGtEUGoWjjQhu9jls1bpYjeLOKA,611
 uipath/_cli/_templates/.rels.template,sha256=-fTcw7OA1AcymHr0LzBqbMAAtzZTRXLTNa_ljq087Jk,406
@@ -97,7 +98,7 @@ uipath/_events/_event_bus.py,sha256=4-VzstyX69cr7wT1EY7ywp-Ndyz2CyemD3Wk_-QmRpo,
 uipath/_events/_events.py,sha256=eCgqEP4rzDgZShXMC9wgBVx-AcpwaJZlo2yiL7OyxdA,4441
 uipath/_resources/AGENTS.md,sha256=nRQNAVeEBaBvuMzXw8uXtMnGebLClUgwIMlgb8_qU9o,1039
 uipath/_resources/CLAUDE.md,sha256=kYsckFWTVe948z_fNWLysCHvi9_YpchBXl3s1Ek03lU,10
-uipath/_resources/CLI_REFERENCE.md,sha256=stB6W2aUr0o9UzZ49h7ZXvltaLhnwPUe4_erko4Nr9k,6262
+uipath/_resources/CLI_REFERENCE.md,sha256=-eCe1hZSRvv9QGLltE3xl8muGWGNzmaHX8htRt3cgy8,6366
 uipath/_resources/REQUIRED_STRUCTURE.md,sha256=3laqGiNa3kauJ7jRI1d7w_fWKUDkqYBjcTT_6_8FAGk,1417
 uipath/_resources/SDK_REFERENCE.md,sha256=4wX8a1W5EJCta-iEHy_cDRahn0ENpJykwn-w4k_Lh6s,23245
 uipath/_services/__init__.py,sha256=_LNy4u--VlhVtTO66bULbCoBjyJBTuyh9jnzjWrv-h4,1140
@@ -109,7 +110,7 @@ uipath/_services/attachments_service.py,sha256=NPQYK7CGjfBaNT_1S5vEAfODmOChTbQZf
 uipath/_services/buckets_service.py,sha256=5s8tuivd7GUZYj774DDUYTa0axxlUuesc4EBY1V5sdk,18496
 uipath/_services/connections_service.py,sha256=tKJHHOKQYKR6LkgB-V_2d0vFpLEdFeMzwj_xmBVHUDw,18416
 uipath/_services/context_grounding_service.py,sha256=Pjx-QQQEiSKD-hY6ityj3QUSALN3fIcKLLHr_NZ0d_g,37117
-uipath/_services/documents_service.py,sha256=UnFS8EpOZ_Ng2TZk3OiJJ3iNANvFs7QxuoG_v-lQj6c,24815
+uipath/_services/documents_service.py,sha256=dVv7kYT2wm4gbtqulSAQhtn418xgzV2yt7gB7JvDsWU,24973
 uipath/_services/entities_service.py,sha256=QKCLE6wRgq3HZraF-M2mljy-8il4vsNHrQhUgkewVVk,14028
 uipath/_services/external_application_service.py,sha256=gZhnGgLn7ZYUZzZF7AumB14QEPanVY-D_02FqEcAFtw,5478
 uipath/_services/folder_service.py,sha256=9JqgjKhWD-G_KUnfUTP2BADxL6OK9QNZsBsWZHAULdE,2749
@@ -121,7 +122,7 @@ uipath/_utils/__init__.py,sha256=VdcpnENJIa0R6Y26NoxY64-wUVyvb4pKfTh1wXDQeMk,526
 uipath/_utils/_auth.py,sha256=5R30ALuRrIatf_0Lk-AETJvt6ora7h0R7yeDdliW1Lg,2524
 uipath/_utils/_endpoint.py,sha256=yYHwqbQuJIevpaTkdfYJS9CrtlFeEyfb5JQK5osTCog,2489
 uipath/_utils/_infer_bindings.py,sha256=eCxfUjd37fOFZ6vOfKl2BhWVUt7iSSJ-VQ0-nDTBcaA,1836
-uipath/_utils/_logs.py,sha256=adfX_0UAn3YBeKJ8DQDeZs94rJyHGQO00uDfkaTpNWQ,510
+uipath/_utils/_logs.py,sha256=ZLH0jyPImy7xAqr81XW-As7bdeIcfJpReombBPh9HAg,450
 uipath/_utils/_read_overwrites.py,sha256=OQgG9ycPpFnLub5ELQdX9V2Fyh6F9_zDR3xoYagJaMI,5287
 uipath/_utils/_request_override.py,sha256=fIVHzgHVXITUlWcp8osNBwIafM1qm4_ejx0ng5UzfJ4,573
 uipath/_utils/_request_spec.py,sha256=iCtBLqtbWUpFG5g1wtIZBzSupKsfaRLiQFoFc_4B70Q,747
@@ -173,7 +174,7 @@ uipath/models/entities.py,sha256=x6jbq4o_QhgL_pCgvHFsp9O8l333kQhn8e9ZCBs72UM,982
 uipath/models/errors.py,sha256=WCxxHBlLzLF17YxjqsFkkyBLwEQM_dc6fFU5qmBjD4A,597
 uipath/models/exceptions.py,sha256=F0ITAhJsl6Agvmnv4nxvgY5oC_lrYIlxWTLs0yx859M,1636
 uipath/models/interrupt_models.py,sha256=UzuVTMVesI204YQ4qFQFaN-gN3kksddkrujofcaC7zQ,881
-uipath/models/job.py,sha256=HOvWS3I2BkiuM9jvg_PF0MezKa_C_8g7tndZpjJ1w50,3063
+uipath/models/job.py,sha256=h1S-ErUk4-oIdrxo4nEBEJdSv1NTTF4AF8LfXx5Exak,3063
 uipath/models/llm_gateway.py,sha256=rUIus7BrUuuRriXqSJUE9FnjOyQ7pYpaX6hWEYvA6AA,1923
 uipath/models/processes.py,sha256=bV31xTyF0hRWZmwy3bWj5L8dBD9wttWxfJjwzhjETmk,1924
 uipath/models/queues.py,sha256=gnbeEyYlHtdqdxBalio0lw8mq-78YBG9MPMSkv1BWOg,6934
@@ -187,8 +188,8 @@ uipath/tracing/_utils.py,sha256=X-LFsyIxDeNOGuHPvkb6T5o9Y8ElYhr_rP3CEBJSu4s,1383
 uipath/utils/__init__.py,sha256=VD-KXFpF_oWexFg6zyiWMkxl2HM4hYJMIUDZ1UEtGx0,105
 uipath/utils/_endpoints_manager.py,sha256=tnF_FiCx8qI2XaJDQgYkMN_gl9V0VqNR1uX7iawuLp8,8230
 uipath/utils/dynamic_schema.py,sha256=w0u_54MoeIAB-mf3GmwX1A_X8_HDrRy6p998PvX9evY,3839
-uipath-2.1.97.dist-info/METADATA,sha256=VSSHUv-YMKThR9fS26EnbcZhKRMP-o0omZVgfeEepTM,6625
-uipath-2.1.97.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-uipath-2.1.97.dist-info/entry_points.txt,sha256=9C2_29U6Oq1ExFu7usihR-dnfIVNSKc-0EFbh0rskB4,43
-uipath-2.1.97.dist-info/licenses/LICENSE,sha256=-KBavWXepyDjimmzH5fVAsi-6jNVpIKFc2kZs0Ri4ng,1058
-uipath-2.1.97.dist-info/RECORD,,
+uipath-2.1.99.dist-info/METADATA,sha256=uzQOaz08OQ0caJ37TK1DW-SC2oGIk-BHNnOMVVe1hVE,6625
+uipath-2.1.99.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+uipath-2.1.99.dist-info/entry_points.txt,sha256=9C2_29U6Oq1ExFu7usihR-dnfIVNSKc-0EFbh0rskB4,43
+uipath-2.1.99.dist-info/licenses/LICENSE,sha256=-KBavWXepyDjimmzH5fVAsi-6jNVpIKFc2kZs0Ri4ng,1058
+uipath-2.1.99.dist-info/RECORD,,