fix: add terminal resume tab

Author: cristipufu

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "uipath"
-version = "2.1.31"
+version = "2.1.32"
 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"

src/uipath/_cli/_dev/_terminal/__init__.py

@@ -17,10 +17,12 @@
     UiPathRuntimeContext,
     UiPathRuntimeError,
     UiPathRuntimeFactory,
+    UiPathRuntimeStatus,
 )
 from ._components._details import RunDetailsPanel
 from ._components._history import RunHistoryPanel
 from ._components._new import NewRunPanel
+from ._components._resume import ResumePanel
 from ._models._execution import ExecutionRun
 from ._models._messages import LogMessage, TraceMessage
 from ._traces._exporter import RunContextExporter
@@ -86,6 +88,8 @@ async def on_button_pressed(self, event: Button.Pressed) -> None:
             await self.action_execute_run()
         elif event.button.id == "cancel-btn":
             await self.action_cancel()
+        elif event.button.id == "resume-btn":
+            await self.action_resume()
 
     async def on_list_view_selected(self, event: ListView.Selected) -> None:
         """Handle run selection from history."""
@@ -109,6 +113,19 @@ async def action_cancel(self) -> None:
         """Cancel and return to new run view."""
         await self.action_new_run()
 
+    async def action_resume(self) -> None:
+        """Resume the suspended run."""
+        details_panel = self.query_one("#details-panel", RunDetailsPanel)
+        if details_panel and details_panel.current_run:
+            input: Dict[str, Any] = {}
+            input_data = self.query_one("#resume-panel", ResumePanel).get_input_values()
+            try:
+                input = json.loads(input_data)
+            except json.JSONDecodeError:
+                return
+            details_panel.current_run.input_data = input
+            asyncio.create_task(self._execute_runtime(details_panel.current_run))
+
     async def action_execute_run(self) -> None:
         """Execute a new run with UiPath runtime."""
         new_run_panel = self.query_one("#new-run-panel", NewRunPanel)
@@ -153,17 +170,27 @@ async def _execute_runtime(self, run: ExecutionRun):
                 ),
             )
 
-            self._add_info_log(run, f"Starting execution: {run.entrypoint}")
+            if run.status == "suspended":
+                context.resume = True
+                self._add_info_log(run, f"Resuming execution: {run.entrypoint}")
+            else:
+                self._add_info_log(run, f"Starting execution: {run.entrypoint}")
+
+            run.status = "running"
+            run.start_time = datetime.now()
 
             result = await self.runtime_factory.execute_in_root_span(context)
 
             if result is not None:
-                run.output_data = result.output
+                if result.status == UiPathRuntimeStatus.SUSPENDED.value:
+                    run.status = "suspended"
+                else:
+                    run.output_data = result.output
+                    run.status = "completed"
                 if run.output_data:
                     self._add_info_log(run, f"Execution result: {run.output_data}")
 
             self._add_info_log(run, "✅ Execution completed successfully")
-            run.status = "completed"
             run.end_time = datetime.now()
 
         except UiPathRuntimeError as e:

src/uipath/_cli/_dev/_terminal/_components/_details.py

@@ -9,6 +9,7 @@
 
 from .._models._execution import ExecutionRun
 from .._models._messages import LogMessage, TraceMessage
+from ._resume import ResumePanel
 
 
 class SpanDetailsDisplay(Container):
@@ -113,6 +114,9 @@ def compose(self) -> ComposeResult:
                     classes="detail-log",
                 )
 
+            with TabPane("Resume", id="resume-tab"):
+                yield ResumePanel(id="resume-panel")
+
     def watch_current_run(
         self, old_value: Optional[ExecutionRun], new_value: Optional[ExecutionRun]
     ):
@@ -140,8 +144,14 @@ def show_run(self, run: ExecutionRun):
         # Clear and rebuild traces tree using TraceMessage objects
         self._rebuild_spans_tree()
 
+    def _update_resume_tab(self, run: ExecutionRun) -> None:
+        resume_panel = self.query_one("#resume-panel", ResumePanel)
+        resume_panel.display = run.status == "suspended"
+
     def _show_run_details(self, run: ExecutionRun):
         """Display detailed information about the run in the Details tab."""
+        self._update_resume_tab(run)
+
         run_details_log = self.query_one("#run-details-log", RichLog)
         run_details_log.clear()
 
@@ -232,25 +242,6 @@ def _show_run_details(self, run: ExecutionRun):
             run_details_log.write(f"[red]\n{run.error.detail}[/red]")
             run_details_log.write("")
 
-        # Additional metadata
-        run_details_log.write("[bold]METADATA:[/bold]")
-        run_details_log.write("[dim]" + "=" * 50 + "[/dim]")
-
-        # Show available attributes
-        for attr in ["id", "status", "start_time", "end_time", "duration_ms"]:
-            if hasattr(run, attr):
-                value = getattr(run, attr)
-                if value is not None:
-                    run_details_log.write(f"  {attr}: {value}")
-
-        # Show traces count
-        traces_count = len(run.traces) if run.traces else 0
-        run_details_log.write(f"  traces_count: {traces_count}")
-
-        # Show logs count
-        logs_count = len(run.logs) if run.logs else 0
-        run_details_log.write(f"  logs_count: {logs_count}")
-
     def _rebuild_spans_tree(self):
         """Rebuild the spans tree from current run's traces."""
         spans_tree = self.query_one("#spans-tree", Tree)

src/uipath/_cli/_dev/_terminal/_components/_resume.py

@@ -0,0 +1,31 @@
+from textual.app import ComposeResult
+from textual.containers import Container, Horizontal, Vertical
+from textual.widgets import Button, TextArea
+
+
+class ResumePanel(Container):
+    """Panel for resuming a suspended run."""
+
+    def __init__(self, **kwargs):
+        super().__init__(**kwargs)
+
+    def compose(self) -> ComposeResult:
+        with Vertical():
+            yield TextArea(
+                text="{}",
+                language="json",
+                id="resume-json-input",
+                classes="input-field json-input",
+            )
+            with Horizontal(classes="run-actions"):
+                yield Button(
+                    "▶ Resume",
+                    id="resume-btn",
+                    variant="primary",
+                    classes="action-btn",
+                )
+
+    def get_input_values(self) -> str:
+        """Return the JSON text to resume with."""
+        json_input = self.query_one("#resume-json-input", TextArea)
+        return json_input.text.strip()

src/uipath/_cli/_dev/_terminal/_models/_execution.py

@@ -37,12 +37,14 @@ def duration(self) -> str:
     def display_name(self) -> Text:
         status_colors = {
             "running": "yellow",
+            "suspended": "cyan",
             "completed": "green",
             "failed": "red",
         }
 
         status_icon = {
             "running": "▶",
+            "suspended": "⏸",
             "completed": "✔",
             "failed": "✖",
         }.get(self.status, "?")

src/uipath/_cli/_dev/_terminal/_styles/terminal.tcss

@@ -117,6 +117,7 @@ Screen {
 }
 
 Footer {
+    margin-top:1;
     height: auto;
     dock: bottom;
 }