uipath 2.1.37__tar.gz → 2.1.39__tar.gz

{uipath-2.1.37 → uipath-2.1.39}/PKG-INFO

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

@@ -1,6 +1,6 @@
 [project]
 name = "uipath"
-version = "2.1.37"
+version = "2.1.39"
 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.37 → uipath-2.1.39}/src/uipath/_cli/_dev/_terminal/__init__.py

@@ -295,7 +295,7 @@ class UiPathDevTerminal(App[Any]):
         if not updated_chat_message:
             return
         details_panel = self.app.query_one("#details-panel", RunDetailsPanel)
-        details_panel.add_chat_message(updated_chat_message, execution_id)
+        details_panel.add_chat_message(event, updated_chat_message, execution_id)
 
     def _add_info_log(self, run: ExecutionRun, message: str):
         """Add info log to run."""

{uipath-2.1.37 → uipath-2.1.39}/src/uipath/_cli/_dev/_terminal/_components/_chat.py

@@ -6,6 +6,7 @@ from textual.containers import Container, Vertical, VerticalScroll
 from textual.widgets import Input, Markdown
 
 from uipath.agent.conversation import (
+    UiPathConversationEvent,
     UiPathConversationMessage,
     UiPathExternalValue,
     UiPathInlineValue,
@@ -17,11 +18,11 @@ class Prompt(Markdown):
 
 
 class Response(Markdown):
-    BORDER_TITLE = "ai"
+    BORDER_TITLE = "🤖 ai"
 
 
 class Tool(Markdown):
-    BORDER_TITLE = "tool"
+    BORDER_TITLE = "🛠️  tool"
 
 
 class ChatPanel(Container):
@@ -43,38 +44,40 @@ class ChatPanel(Container):
                 id="chat-input",
             )
 
-    def add_chat_message(self, chat_msg: UiPathConversationMessage) -> None:
+    def add_chat_message(
+        self, event: UiPathConversationEvent, chat_msg: UiPathConversationMessage
+    ) -> None:
         """Add or update a chat message bubble."""
         chat_view = self.query_one("#chat-view")
 
         widget_cls: Union[type[Prompt], type[Response], type[Tool]]
         if chat_msg.role == "user":
             widget_cls = Prompt
-            prefix = "👤"
         elif chat_msg.role == "assistant":
             widget_cls = Response
-            prefix = "🤖"
         else:
             widget_cls = Response
-            prefix = "⚒️"
 
         parts: List[str] = []
         if chat_msg.content_parts:
             for part in chat_msg.content_parts:
-                if part.mime_type.startswith("text/"):
+                if (
+                    part.mime_type.startswith("text/")
+                    or part.mime_type == "application/json"
+                ):
                     if isinstance(part.data, UiPathInlineValue):
                         parts.append(part.data.inline or "")
                     elif isinstance(part.data, UiPathExternalValue):
-                        # maybe fetch from URL or just show a placeholder
                         parts.append(f"[external: {part.data.url}]")
 
         text_block = "\n".join(parts).strip()
-        content_lines = [f"{prefix} {text_block}"] if text_block else []
+        content_lines = [f"{text_block}"] if text_block else []
 
         if chat_msg.tool_calls:
+            widget_cls = Tool
             for call in chat_msg.tool_calls:
-                args = call.arguments
-                content_lines.append(f"🛠 **{call.name}**\n{args}")
+                status_icon = "✓" if call.result else "⚙"
+                content_lines.append(f" {status_icon} **{call.name}**")
 
         if not content_lines:
             return
@@ -86,7 +89,12 @@ class ChatPanel(Container):
         last_update = self._last_update_time.get(chat_msg.message_id, 0.0)
 
         if existing:
-            if now - last_update > 0.15:
+            should_update = (
+                event.exchange
+                and event.exchange.message
+                and event.exchange.message.end is not None
+            )
+            if should_update or now - last_update > 0.15:
                 existing.update(content)
                 self._last_update_time[chat_msg.message_id] = now
                 chat_view.scroll_end(animate=False)

{uipath-2.1.37 → uipath-2.1.39}/src/uipath/_cli/_dev/_terminal/_components/_details.py

@@ -6,7 +6,7 @@ from textual.reactive import reactive
 from textual.widgets import Input, RichLog, TabbedContent, TabPane, Tree
 from textual.widgets.tree import TreeNode
 
-from uipath.agent.conversation import UiPathConversationMessage
+from uipath.agent.conversation import UiPathConversationEvent, UiPathConversationMessage
 
 from .._models._execution import ExecutionRun
 from .._models._messages import LogMessage, TraceMessage
@@ -430,13 +430,16 @@ class RunDetailsPanel(Container):
             logs_log.write(log_msg.message)
 
     def add_chat_message(
-        self, chat_msg: UiPathConversationMessage, run_id: str
+        self,
+        event: UiPathConversationEvent,
+        chat_msg: UiPathConversationMessage,
+        run_id: str,
     ) -> None:
         """Add a chat message to the display."""
         if not self.current_run or run_id != self.current_run.id:
             return
         chat_panel = self.query_one("#chat-panel", ChatPanel)
-        chat_panel.add_chat_message(chat_msg)
+        chat_panel.add_chat_message(event, chat_msg)
 
     def clear_display(self):
         """Clear both traces and logs display."""

{uipath-2.1.37 → uipath-2.1.39}/src/uipath/_cli/_dev/_terminal/_styles/terminal.tcss

@@ -226,15 +226,16 @@ TextArea.invalid {
 
 
 Prompt {
-    background: $primary 5%;
+    border: wide $primary-background;
+    background: $surface;
     color: $text;
     margin-right: 8;
     margin-left: 1;
     padding: 1 1 0 1;
 }
 Response, Tool {
-    border: wide $success;
-    background: $success 5%;
+    border: wide $primary-background;
+    background: $surface;
     color: $text;
     margin: 1;
     margin-left: 8;

{uipath-2.1.37 → uipath-2.1.39}/src/uipath/_cli/_dev/_terminal/_utils/_chat.py

@@ -74,9 +74,10 @@ class ConversationAggregator:
             )
             self.messages[ev.message_id] = msg
 
-        # --- Handle content parts ---
+        # --- Handle content parts (text, JSON, etc.) ---
         if ev.content_part:
             cp_event = ev.content_part
+
             existing = next(
                 (
                     cp
@@ -86,27 +87,41 @@ class ConversationAggregator:
                 None,
             )
 
-            if cp_event.start:
+            # Start of a new content part
+            if cp_event.start and not existing:
+                new_cp = UiPathConversationContentPart(
+                    content_part_id=cp_event.content_part_id,
+                    mime_type=cp_event.start.mime_type,
+                    data=UiPathInlineValue(inline=""),
+                    citations=[],
+                    is_transcript=None,
+                    is_incomplete=True,
+                )
+                if msg.content_parts is None:
+                    msg.content_parts = []
+                msg.content_parts.append(new_cp)
+                existing = new_cp
+
+            # Chunk for an existing part (or backfill if start missing)
+            if cp_event.chunk:
                 if not existing:
+                    new_cp = UiPathConversationContentPart(
+                        content_part_id=cp_event.content_part_id,
+                        mime_type="text/plain",  # fallback if start missing
+                        data=UiPathInlineValue(inline=""),
+                        citations=[],
+                        is_transcript=None,
+                        is_incomplete=True,
+                    )
                     if msg.content_parts is None:
                         msg.content_parts = []
-                    msg.content_parts.append(
-                        UiPathConversationContentPart(
-                            content_part_id=cp_event.content_part_id,
-                            mime_type=cp_event.start.mime_type,
-                            data=UiPathInlineValue(
-                                inline=cp_event.chunk.data
-                                if cp_event.chunk and cp_event.chunk.data
-                                else ""
-                            ),
-                            citations=[],
-                            is_transcript=None,
-                            is_incomplete=None,
-                        )
-                    )
-            if cp_event.chunk and existing:
+                    msg.content_parts.append(new_cp)
+                    existing = new_cp
+
                 if isinstance(existing.data, UiPathInlineValue):
                     existing.data.inline += cp_event.chunk.data or ""
+
+            # End of a part
             if cp_event.end and existing:
                 existing.is_incomplete = bool(cp_event.end.interrupted)
 
@@ -122,43 +137,31 @@ class ConversationAggregator:
                 None,
             )
 
+            # Start of a tool call
             if tc_event.start:
                 if not existing_tool_call:
-                    # create new tool call
                     new_tc = UiPathConversationToolCall(
                         tool_call_id=tc_event.tool_call_id,
                         name=tc_event.start.tool_name,
-                        arguments=tc_event.start.arguments,
+                        arguments=None,  # args will arrive as JSON content part
                         timestamp=tc_event.start.timestamp,
                         result=None,
                     )
                     if msg.tool_calls is None:
                         msg.tool_calls = []
                     msg.tool_calls.append(new_tc)
+                    existing_tool_call = new_tc
                 else:
-                    # merge/update existing
                     existing_tool_call.name = (
                         tc_event.start.tool_name or existing_tool_call.name
                     )
-                    if tc_event.start.arguments:
-                        # If Inline, append more data
-                        if isinstance(
-                            tc_event.start.arguments, UiPathInlineValue
-                        ) and isinstance(
-                            existing_tool_call.arguments, UiPathInlineValue
-                        ):
-                            existing_tool_call.arguments.inline += (
-                                tc_event.start.arguments.inline or ""
-                            )
-                        else:
-                            existing_tool_call.arguments = tc_event.start.arguments
                     existing_tool_call.timestamp = (
                         tc_event.start.timestamp or existing_tool_call.timestamp
                     )
 
+            # End of a tool call
             if tc_event.end:
                 if not existing_tool_call:
-                    # Shouldn't happen, but initialize if end comes first
                     existing_tool_call = UiPathConversationToolCall(
                         tool_call_id=tc_event.tool_call_id,
                         name="",  # unknown until start seen
@@ -177,7 +180,6 @@ class ConversationAggregator:
 
         # --- Update timestamps ---
         msg.updated_at = self._timestamp(ev)
-
         return msg
 
     def _timestamp(self, ev: UiPathConversationMessageEvent) -> str:

{uipath-2.1.37 → uipath-2.1.39}/src/uipath/_cli/_runtime/_hitl.py

@@ -92,7 +92,8 @@ class HitlReader:
                             _try_convert_to_json_format(str(job.job_error or job.info))
                             or "Job error unavailable.",
                         )
-                    return _try_convert_to_json_format(job.output_arguments)
+                    output_data = await uipath.jobs.extract_output_async(job)
+                    return _try_convert_to_json_format(output_data)
 
             case UiPathResumeTriggerType.API:
                 if resume_trigger.api_resume and resume_trigger.api_resume.inbox_id:

{uipath-2.1.37 → uipath-2.1.39}/src/uipath/_services/jobs_service.py

@@ -351,6 +351,54 @@ class JobsService(FolderContext, BaseService):
             },
         )
 
+    def extract_output(self, job: Job) -> Optional[str]:
+        """Get the actual output data, downloading from attachment if necessary.
+
+        Args:
+            job: The job instance to fetch output data from.
+
+        Returns:
+            Parsed output arguments as dictionary, or None if no output
+        """
+        if job.output_file:
+            # Large output stored as attachment
+            with tempfile.TemporaryDirectory() as temp_dir:
+                temp_path = Path(temp_dir) / f"output_{job.output_file}"
+                self._attachments_service.download(
+                    key=uuid.UUID(job.output_file), destination_path=temp_path
+                )
+                with open(temp_path, "r", encoding="utf-8") as f:
+                    return f.read()
+        elif job.output_arguments:
+            # Small output stored inline
+            return job.output_arguments
+        else:
+            return None
+
+    async def extract_output_async(self, job: Job) -> Optional[str]:
+        """Asynchronously fetch the actual output data, downloading from attachment if necessary.
+
+        Args:
+            job: The job instance to fetch output data from.
+
+        Returns:
+            Parsed output arguments as dictionary, or None if no output
+        """
+        if job.output_file:
+            # Large output stored as attachment
+            with tempfile.TemporaryDirectory() as temp_dir:
+                temp_path = Path(temp_dir) / f"output_{job.output_file}"
+                await self._attachments_service.download_async(
+                    key=uuid.UUID(job.output_file), destination_path=temp_path
+                )
+                with open(temp_path, "r", encoding="utf-8") as f:
+                    return f.read()
+        elif job.output_arguments:
+            # Small output stored inline
+            return job.output_arguments
+        else:
+            return None
+
     def _resume_spec(
         self,
         *,

{uipath-2.1.37 → uipath-2.1.39}/src/uipath/_services/processes_service.py

@@ -1,5 +1,6 @@
 import json
 import os
+import uuid
 from typing import Any, Dict, Optional
 
 from .._config import Config
@@ -9,6 +10,7 @@ from .._utils import Endpoint, RequestSpec, header_folder, infer_bindings
 from .._utils.constants import ENV_JOB_ID, HEADER_JOB_KEY
 from ..models.job import Job
 from ..tracing._traced import traced
+from . import AttachmentsService
 from ._base_service import BaseService
 
 
@@ -20,7 +22,13 @@ class ProcessesService(FolderContext, BaseService):
     specific business tasks.
     """
 
-    def __init__(self, config: Config, execution_context: ExecutionContext) -> None:
+    def __init__(
+        self,
+        config: Config,
+        execution_context: ExecutionContext,
+        attachment_service: AttachmentsService,
+    ) -> None:
+        self._attachments_service = attachment_service
         super().__init__(config=config, execution_context=execution_context)
 
     @traced(name="processes_invoke", run_type="uipath")
@@ -65,9 +73,14 @@ class ProcessesService(FolderContext, BaseService):
             client.processes.invoke(name="MyProcess", folder_path="my-folder-key")
             ```
         """
+        input_data = self._handle_input_arguments(
+            input_arguments=input_arguments,
+            folder_key=folder_key,
+            folder_path=folder_path,
+        )
         spec = self._invoke_spec(
             name,
-            input_arguments=input_arguments,
+            input_data=input_data,
             folder_key=folder_key,
             folder_path=folder_path,
         )
@@ -118,9 +131,14 @@ class ProcessesService(FolderContext, BaseService):
             asyncio.run(main())
             ```
         """
+        input_data = await self._handle_input_arguments_async(
+            input_arguments=input_arguments,
+            folder_key=folder_key,
+            folder_path=folder_path,
+        )
         spec = self._invoke_spec(
             name,
-            input_arguments=input_arguments,
+            input_data=input_data,
             folder_key=folder_key,
             folder_path=folder_path,
         )
@@ -138,29 +156,87 @@ class ProcessesService(FolderContext, BaseService):
     def custom_headers(self) -> Dict[str, str]:
         return self.folder_headers
 
+    def _handle_input_arguments(
+        self,
+        input_arguments: Optional[Dict[str, Any]] = None,
+        *,
+        folder_key: Optional[str] = None,
+        folder_path: Optional[str] = None,
+    ) -> Dict[str, str]:
+        """Handle input arguments, storing as attachment if they exceed size limit.
+
+        Args:
+            input_arguments: The input arguments to process
+            folder_key: The folder key for attachment storage
+            folder_path: The folder path for attachment storage
+
+        Returns:
+            Dict containing either "InputArguments" or "InputFile" key
+        """
+        if not input_arguments:
+            return {"InputArguments": json.dumps({})}
+
+        # If payload exceeds limit, store as attachment
+        payload_json = json.dumps(input_arguments)
+        if len(payload_json) > 10000:  # 10k char limit
+            attachment_id = self._attachments_service.upload(
+                name=f"{uuid.uuid4()}.json",
+                content=payload_json,
+                folder_key=folder_key,
+                folder_path=folder_path,
+            )
+            return {"InputFile": str(attachment_id)}
+        else:
+            return {"InputArguments": payload_json}
+
+    async def _handle_input_arguments_async(
+        self,
+        input_arguments: Optional[Dict[str, Any]] = None,
+        *,
+        folder_key: Optional[str] = None,
+        folder_path: Optional[str] = None,
+    ) -> Dict[str, str]:
+        """Handle input arguments, storing as attachment if they exceed size limit.
+
+        Args:
+            input_arguments: The input arguments to process
+            folder_key: The folder key for attachment storage
+            folder_path: The folder path for attachment storage
+
+        Returns:
+            Dict containing either "InputArguments" or "InputFile" key
+        """
+        if not input_arguments:
+            return {"InputArguments": json.dumps({})}
+
+        # If payload exceeds limit, store as attachment
+        payload_json = json.dumps(input_arguments)
+        if len(payload_json) > 10000:  # 10k char limit
+            attachment_id = await self._attachments_service.upload_async(
+                name=f"{uuid.uuid4()}.json",
+                content=payload_json,
+                folder_key=folder_key,
+                folder_path=folder_path,
+            )
+            return {"InputFile": str(attachment_id)}
+        else:
+            return {"InputArguments": payload_json}
+
     def _invoke_spec(
         self,
         name: str,
-        input_arguments: Optional[Dict[str, Any]] = None,
+        input_data: Optional[Dict[str, Any]] = None,
         *,
         folder_key: Optional[str] = None,
         folder_path: Optional[str] = None,
     ) -> RequestSpec:
+        input_dict = {"startInfo": {"ReleaseName": name, **(input_data or {})}}
         request_scope = RequestSpec(
             method="POST",
             endpoint=Endpoint(
                 "/orchestrator_/odata/Jobs/UiPath.Server.Configuration.OData.StartJobs"
             ),
-            content=str(
-                {
-                    "startInfo": {
-                        "ReleaseName": name,
-                        "InputArguments": json.dumps(input_arguments)
-                        if input_arguments
-                        else "{}",
-                    }
-                }
-            ),
+            content=str(input_dict),
             headers={
                 **header_folder(folder_key, folder_path),
             },

{uipath-2.1.37 → uipath-2.1.39}/src/uipath/_uipath.py

@@ -57,6 +57,7 @@ class UiPath:
                     raise SecretMissingError() from e
         self._folders_service: Optional[FolderService] = None
         self._buckets_service: Optional[BucketsService] = None
+        self._attachments_service: Optional[AttachmentsService] = None
 
         setup_logging(debug)
         self._execution_context = ExecutionContext()
@@ -71,11 +72,15 @@ class UiPath:
 
     @property
     def attachments(self) -> AttachmentsService:
-        return AttachmentsService(self._config, self._execution_context)
+        if not self._attachments_service:
+            self._attachments_service = AttachmentsService(
+                self._config, self._execution_context
+            )
+        return self._attachments_service
 
     @property
     def processes(self) -> ProcessesService:
-        return ProcessesService(self._config, self._execution_context)
+        return ProcessesService(self._config, self._execution_context, self.attachments)
 
     @property
     def actions(self) -> ActionsService:

{uipath-2.1.37 → uipath-2.1.39}/src/uipath/models/job.py

@@ -58,7 +58,9 @@ class Job(BaseModel):
     deleter_user_id: Optional[int] = Field(default=None, alias="DeleterUserId")
     is_deleted: Optional[bool] = Field(default=None, alias="IsDeleted")
     input_arguments: Optional[str] = Field(default=None, alias="InputArguments")
+    input_file: Optional[str] = Field(default=None, alias="InputFile")
     output_arguments: Optional[str] = Field(default=None, alias="OutputArguments")
+    output_file: Optional[str] = Field(default=None, alias="OutputFile")
     host_machine_name: Optional[str] = Field(default=None, alias="HostMachineName")
     has_errors: Optional[bool] = Field(default=None, alias="HasErrors")
     has_warnings: Optional[bool] = Field(default=None, alias="HasWarnings")