pipecatcloud 0.2.17__tar.gz → 0.2.19__tar.gz

{pipecatcloud-0.2.17 → pipecatcloud-0.2.19}/CHANGELOG.md

@@ -5,6 +5,28 @@ All notable changes to **Pipecat Cloud** will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.19] - 2026-01-27
+
+### Added
+
+- Added detailed session view with resource metrics. Use `pcc agent sessions <agent> --id <session-id>`
+  to see CPU and memory usage with sparkline visualizations and percentile summaries.
+
+## [0.2.18] - 2026-01-06
+
+### Added
+
+- Return the session ID when starting an agent session.
+
+### Changed
+
+- Improved `auth login` UX to display authentication code and URL before opening
+  browser. Users now press Enter to open browser or 'q' to quit, ensuring the
+  authentication code is visible before browser takes focus.
+
+- Relaxed `synchronicity` version to ">=0.11,<1.0.0" for better compatibilty
+  with other libraries.
+
 ## [0.2.17] - 2025-12-26
 
 ### Changed

{pipecatcloud-0.2.17 → pipecatcloud-0.2.19}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pipecatcloud
-Version: 0.2.17
+Version: 0.2.19
 Summary: Cloud hosting for Pipecat AI applications
 License: BSD 2-Clause License
 Project-URL: Website, https://docs.pipecat.daily.co/
@@ -14,7 +14,7 @@ Requires-Dist: loguru~=0.7.3
 Requires-Dist: python-dotenv<2.0.0,>=1.0.1
 Requires-Dist: uvicorn<1.0.0,>=0.32.0
 Requires-Dist: typer<1,>=0.20.0
-Requires-Dist: synchronicity~=0.7.6
+Requires-Dist: synchronicity<1.0.0,>=0.11
 Requires-Dist: toml~=0.10.2
 Requires-Dist: questionary~=2.1.0
 Provides-Extra: pipecat

{pipecatcloud-0.2.17 → pipecatcloud-0.2.19}/pyproject.toml

@@ -17,7 +17,7 @@ dependencies = [
     "python-dotenv>=1.0.1,<2.0.0",
     "uvicorn>=0.32.0,<1.0.0",
     "typer>=0.20.0,<1",
-    "synchronicity~=0.7.6",
+    "synchronicity>=0.11,<1.0.0",
     "toml~=0.10.2",
     "questionary~=2.1.0"
 ]

{pipecatcloud-0.2.17 → pipecatcloud-0.2.19}/src/pipecatcloud/api.py

@@ -475,6 +475,20 @@ class _API:
     def agent_sessions(self):
         return self.create_api_method(self._agent_sessions)
 
+    async def _agent_session(self, agent_name: str, session_id: str, org: str) -> dict | None:
+        url = f"{self.construct_api_url('services_sessions_path').format(org=org, service=agent_name)}/{session_id}"
+        return await self._base_request("GET", url, not_found_is_empty=True)
+
+    @property
+    def agent_session(self):
+        """Get details for a specific session including resource metrics.
+        Args:
+            agent_name: Name of the agent
+            session_id: ID of the session
+            org: Organization ID
+        """
+        return self.create_api_method(self._agent_session)
+
     async def _agent_session_terminate(
         self, agent_name: str, session_id: str, org: str
     ) -> dict | None:

{pipecatcloud-0.2.17 → pipecatcloud-0.2.19}/src/pipecatcloud/cli/commands/agent.py

@@ -38,6 +38,46 @@ from pipecatcloud.constants import Region
 agent_cli = typer.Typer(name="agent", help="Agent management", no_args_is_help=True)
 
 
+def sparkline(values: list[int | float], max_width: int = 50) -> str:
+    """Generate Unicode sparkline from values, downsampling if needed."""
+    if not values:
+        return ""
+
+    # Downsample if too many values
+    if len(values) > max_width:
+        bucket_size = len(values) / max_width
+        downsampled = []
+        for i in range(max_width):
+            start = int(i * bucket_size)
+            end = int((i + 1) * bucket_size)
+            bucket = values[start:end]
+            downsampled.append(sum(bucket) / len(bucket) if bucket else 0)
+        values = downsampled
+
+    blocks = "▁▂▃▄▅▆▇█"
+    lo, hi = min(values), max(values)
+    if hi == lo:
+        return blocks[4] * len(values)  # flat line
+    scale = (hi - lo) / 7
+    return "".join(blocks[min(7, int((v - lo) / scale))] for v in values)
+
+
+def format_bytes(b: int) -> str:
+    """Format bytes as human-readable string."""
+    if b >= 1024 * 1024 * 1024:
+        return f"{b / (1024 * 1024 * 1024):.1f}GB"
+    if b >= 1024 * 1024:
+        return f"{b / (1024 * 1024):.0f}MB"
+    if b >= 1024:
+        return f"{b / 1024:.0f}KB"
+    return f"{b}B"
+
+
+def format_cpu(millicores: int) -> str:
+    """Format CPU millicores as human-readable string."""
+    return f"{millicores / 1000:.2f} cores"
+
+
 # ----- Agent Commands -----
 
 
@@ -292,6 +332,90 @@ async def sessions(
             console.error("No target agent name provided")
             return typer.Exit(1)
 
+    # If session_id is specified, fetch single session with detailed metrics
+    if session_id:
+        with Live(
+            console.status(f"[dim]Looking up session '{session_id}'[/dim]", spinner="dots")
+        ) as live:
+            data, error = await API.agent_session(
+                agent_name=agent_name, session_id=session_id, org=org, live=live
+            )
+            live.stop()
+
+            if error:
+                return typer.Exit()
+
+            if not data:
+                console.error(f"Session '{session_id}' not found")
+                return typer.Exit()
+
+            # Display detailed session view
+            session_duration = format_duration(data.get("createdAt"), data.get("endedAt")) or "N/A"
+            status = data.get("completionStatus", "")
+            if data.get("endedAt"):
+                status_display = "[red]Error (500)[/red]" if status == "500" else "Complete"
+            else:
+                status_display = "[yellow]Active[/yellow]"
+
+            # Build session info panel
+            info_lines = [
+                f"[bold]Session ID:[/bold] {data['sessionId']}",
+                f"[bold]Status:[/bold] {status_display}"
+                + (f" ({status})" if status and status != "500" else ""),
+                f"[bold]Duration:[/bold] {session_duration}",
+                f"[bold]Created:[/bold] {format_timestamp(data.get('createdAt'))}",
+                f"[bold]Ended:[/bold] {format_timestamp(data.get('endedAt')) if data.get('endedAt') else '[dim]N/A[/dim]'}",
+                f"[bold]Bot Start:[/bold] {data.get('botStartSeconds')}s"
+                if data.get("botStartSeconds") is not None
+                else "[bold]Bot Start:[/bold] [dim]N/A[/dim]",
+                f"[bold]Cold Start:[/bold] {'[red]Yes[/red]' if data.get('coldStart') else 'No'}",
+            ]
+
+            # Add resource metrics if available
+            metrics = data.get("resourceMetrics")
+            if metrics:
+                timeseries = metrics.get("timeseries", [])
+                sample_count = metrics.get("sampleCount", 0)
+
+                # Calculate duration from timeseries
+                if len(timeseries) >= 2:
+                    ts_duration = timeseries[-1].get("t", 0) - timeseries[0].get("t", 0)
+                    ts_duration_str = f"{ts_duration}s"
+                else:
+                    ts_duration_str = "N/A"
+
+                info_lines.append("")
+                info_lines.append(
+                    f"[bold]Resource Metrics[/bold] ({sample_count} samples over {ts_duration_str}):"
+                )
+
+                # CPU sparkline and percentiles
+                cpu_values = [s.get("c", 0) for s in timeseries]
+                cpu_spark = sparkline(cpu_values) if cpu_values else ""
+                cpu_p50 = metrics.get("cpuMillicoresP50", 0)
+                cpu_p99 = metrics.get("cpuMillicoresP99", 0)
+                info_lines.append(
+                    f"  CPU:    {cpu_spark}  p50: {format_cpu(cpu_p50)}  p99: {format_cpu(cpu_p99)}"
+                )
+
+                # Memory sparkline and percentiles
+                mem_values = [s.get("m", 0) for s in timeseries]
+                mem_spark = sparkline(mem_values) if mem_values else ""
+                mem_p50 = int(metrics.get("memoryBytesP50", 0))
+                mem_p99 = int(metrics.get("memoryBytesP99", 0))
+                info_lines.append(
+                    f"  Memory: {mem_spark}  p50: {format_bytes(mem_p50)}  p99: {format_bytes(mem_p99)}"
+                )
+
+            console.success(
+                Panel(
+                    "\n".join(info_lines),
+                    title=f"Session details for agent [bold]{agent_name}[/bold] [dim]({org})[/dim]",
+                    title_align="left",
+                ),
+            )
+            return
+
     with Live(
         console.status(f"[dim]Looking up agent with name '{agent_name}'[/dim]", spinner="dots")
     ) as live:
@@ -765,6 +889,7 @@ async def start(
         live.stop()
 
         console.success(f"Agent '{agent_name}' started successfully")
+
         if use_daily and isinstance(data, dict):
             daily_room = data.get("dailyRoom")
             daily_token = data.get("dailyToken")
@@ -773,6 +898,11 @@ async def start(
                 console.print("\nJoin your session by visiting the link below:")
                 console.print(f"[link={url}]{url}[/link]")
 
+        if isinstance(data, dict):
+            session_id = data.get("sessionId")
+            if session_id:
+                console.print(f"\nSession ID: {session_id}")
+
 
 @agent_cli.command(name="stop", help="Stop an active agent session")
 @synchronizer.create_blocking

{pipecatcloud-0.2.17 → pipecatcloud-0.2.19}/src/pipecatcloud/cli/commands/auth.py

@@ -6,8 +6,8 @@
 
 import asyncio
 import itertools
-import webbrowser
 import os
+import webbrowser
 from contextlib import asynccontextmanager
 from typing import AsyncGenerator, Optional, Tuple
 
@@ -160,9 +160,30 @@ async def login(
                 )
                 return
 
-            # Display the code if it was provided
-            if code:
-                console.print(f"[bold]Authentication code:[/bold] [cyan]{code}[/cyan]\n")
+            # Display the authentication URL and code
+            console.print(
+                Panel(
+                    "[bold]To authenticate with Pipecat Cloud:[/bold]\n\n"
+                    "Visit this URL:\n"
+                    f"[blue][link={web_url}]{web_url}[/link][/blue]\n\n"
+                    "Then enter this code:\n"
+                    f"[cyan bold]{code}[/cyan bold]",
+                    title="[bold]Authentication Required[/bold]",
+                    border_style="blue",
+                )
+            )
+
+            # Prompt user to open the browser (unless in headless mode)
+            if not headless:
+                response = typer.prompt(
+                    "\nPress Enter to open the browser (or 'q' to quit)",
+                    default="",
+                    show_default=False,
+                )
+                if response.lower() == "q":
+                    console.print("[yellow]Authentication cancelled[/yellow]")
+                    return typer.Exit()
+                _open_url(web_url)
 
             with Live(
                 console.status(
@@ -170,26 +191,6 @@ async def login(
                 ),
                 transient=True,
             ) as live:
-                # Open the web url in the browser
-                if not headless and _open_url(web_url):
-                    live.update(
-                        console.status(
-                            Panel(
-                                "The web browser should have opened for you to authenticate with Pipecat Cloud.\n"
-                                "If it didn't, please copy this URL into your web browser manually:\n\n"
-                                f"[blue][link={web_url}]{web_url}[/link][/blue]\n",
-                            )
-                        )
-                    )
-                else:
-                    # For headless use-cases, just print the URL
-                    live.stop()
-                    console.print("[dim]Unable to launch web browser[/dim]")
-                    console.print("[bold]Please visit the following URL to confirm login[/bold]\n")
-                    console.print(web_url)
-
-                live.start()
-
                 for attempt in itertools.count():
                     result = await auth_flow.finish()
                     if result is not None:

{pipecatcloud-0.2.17 → pipecatcloud-0.2.19}/src/pipecatcloud.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pipecatcloud
-Version: 0.2.17
+Version: 0.2.19
 Summary: Cloud hosting for Pipecat AI applications
 License: BSD 2-Clause License
 Project-URL: Website, https://docs.pipecat.daily.co/
@@ -14,7 +14,7 @@ Requires-Dist: loguru~=0.7.3
 Requires-Dist: python-dotenv<2.0.0,>=1.0.1
 Requires-Dist: uvicorn<1.0.0,>=0.32.0
 Requires-Dist: typer<1,>=0.20.0
-Requires-Dist: synchronicity~=0.7.6
+Requires-Dist: synchronicity<1.0.0,>=0.11
 Requires-Dist: toml~=0.10.2
 Requires-Dist: questionary~=2.1.0
 Provides-Extra: pipecat

{pipecatcloud-0.2.17 → pipecatcloud-0.2.19}/src/pipecatcloud.egg-info/requires.txt

@@ -4,7 +4,7 @@ loguru~=0.7.3
 python-dotenv<2.0.0,>=1.0.1
 uvicorn<1.0.0,>=0.32.0
 typer<1,>=0.20.0
-synchronicity~=0.7.6
+synchronicity<1.0.0,>=0.11
 toml~=0.10.2
 questionary~=2.1.0