pipecatcloud 0.2.1__tar.gz → 0.2.2__tar.gz

{pipecatcloud-0.2.1 → pipecatcloud-0.2.2}/CHANGELOG.md

@@ -5,10 +5,46 @@ 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).
 
-## [Unreleased]
+## [0.2.2] - 2025-08-18
 
+### Added
+
+- Added `RunnerArguments` as a fallback type in the event that the Pipecat
+  development runner is not imported.
+
+### Changed
+
+- Updated the `typer` dependency to support a range of versions in order to
+  resolve conflicts with other packages. The new range supported is:
+  `"typer>=0.15.3,<0.17.0"`.
+
+- Relaxed the package requirements for `python-dotenv` and `uvicorn` to make it
+  easier to work with Pipecat Cloud. The new supported versions are:
+
+  - `"python-dotenv>=1.0.1,<2.0.0"`
+  - `"uvicorn>=0.32.0,<1.0.0"`
+
+- Updated all types to inherit from `RunnerArguments` to align the types with
+  the Pipecat development runner types. This adds types:
+
+  - `handle_sigint`
+  - `handle_sigterm`
+  - `pipeline_idle_timeout_secs`
+
+### Fixed
+
+- Fixed `ZeroDivisionError` in `agent sessions` command when calculating
+  metrics for agents with zero sessions.
+
+- Fixed `UnboundLocalError` in `agent sessions` command where
+  `metric_renderables` was referenced before assignment due to earlier logic
+  failures.
+
+- `agent sessions` command previously threw `AttributeError` when no agent name
+  was provided via command line or `pcc-deploy.toml`, it now exits gracefully
+  with a clear error message.
 
-##  [0.2.1] - 2025-08-02
+## [0.2.1] - 2025-08-02
 
 ### Added
 

{pipecatcloud-0.2.1/src/pipecatcloud.egg-info → pipecatcloud-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pipecatcloud
-Version: 0.2.1
+Version: 0.2.2
 Summary: Cloud hosting for Pipecat AI applications
 License: BSD 2-Clause License
 Project-URL: Website, https://docs.pipecat.daily.co/
@@ -11,14 +11,14 @@ License-File: LICENSE
 Requires-Dist: aiohttp<4.0.0,>=3.11.12
 Requires-Dist: fastapi<0.117.0,>=0.115.6
 Requires-Dist: loguru~=0.7.3
-Requires-Dist: python-dotenv~=1.0.1
-Requires-Dist: uvicorn~=0.32.0
-Requires-Dist: typer~=0.15.3
+Requires-Dist: python-dotenv<2.0.0,>=1.0.1
+Requires-Dist: uvicorn<1.0.0,>=0.32.0
+Requires-Dist: typer<0.17.0,>=0.15.3
 Requires-Dist: synchronicity~=0.7.6
 Requires-Dist: toml~=0.10.2
 Requires-Dist: questionary~=2.1.0
 Provides-Extra: pipecat
-Requires-Dist: pipecat-ai>=0.0.77; extra == "pipecat"
+Requires-Dist: pipecat-ai>=0.0.79; extra == "pipecat"
 Dynamic: license-file
 
 <h1><div align="center">

{pipecatcloud-0.2.1 → pipecatcloud-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pipecatcloud"
-version = "0.2.1"
+version = "0.2.2"
 requires-python = ">=3.10"
 description = "Cloud hosting for Pipecat AI applications"
 license = { text = "BSD 2-Clause License" }
@@ -14,16 +14,16 @@ dependencies = [
     "aiohttp>=3.11.12,<4.0.0",
     "fastapi>=0.115.6,<0.117.0",
     "loguru~=0.7.3",
-    "python-dotenv~=1.0.1",
-    "uvicorn~=0.32.0",
-    "typer~=0.15.3",
+    "python-dotenv>=1.0.1,<2.0.0",
+    "uvicorn>=0.32.0,<1.0.0",
+    "typer>=0.15.3,<0.17.0",
     "synchronicity~=0.7.6",
     "toml~=0.10.2",
     "questionary~=2.1.0"
 ]
 
 [project.optional-dependencies]
-pipecat = ["pipecat-ai>=0.0.77"]
+pipecat = ["pipecat-ai>=0.0.79"]
 
 [project.scripts]
 pcc = "pipecatcloud.__main__:main"

pipecatcloud-0.2.2/pytest.ini

@@ -0,0 +1,14 @@
+[tool:pytest]
+# Basic pytest configuration
+
+testpaths = tests
+python_files = test_*.py
+# Modern import mode for better import control with src/ layout
+addopts = --import-mode=importlib
+
+# Async support for CLI command tests
+asyncio_mode = auto
+
+# Markers actually used in tests
+markers =
+    asyncio: mark test as async test

{pipecatcloud-0.2.1 → pipecatcloud-0.2.2}/src/pipecatcloud/agent.py

@@ -14,6 +14,7 @@ from fastapi import WebSocket
 try:
     from pipecat.runner.types import (
         DailyRunnerArguments,
+        RunnerArguments,
         WebSocketRunnerArguments,
     )
 
@@ -23,7 +24,25 @@ except ImportError:
 
     # Fallback definitions
     @dataclass
-    class DailyRunnerArguments:
+    class RunnerArguments:
+        """Base class for runner session arguments.
+
+        .. deprecated:: 0.2.2
+            Install pipecatcloud[pipecat] for better compatibility. This class
+            will be removed in a future release.
+        """
+
+        handle_sigint: bool
+        handle_sigterm: bool
+        pipeline_idle_timeout_secs: int
+
+        def __post_init__(self):
+            self.handle_sigint = False
+            self.handle_sigterm = False
+            self.pipeline_idle_timeout_secs = 300
+
+    @dataclass
+    class DailyRunnerArguments(RunnerArguments):
         """Fallback Daily runner arguments when pipecat-ai not available.
 
         .. deprecated:: 0.2.1
@@ -35,7 +54,7 @@ except ImportError:
         body: Any
 
     @dataclass
-    class WebSocketRunnerArguments:
+    class WebSocketRunnerArguments(RunnerArguments):
         """Fallback WebSocket runner arguments when pipecat-ai not available.
 
         .. deprecated:: 0.2.1
@@ -72,13 +91,13 @@ class SessionArguments:
 
 
 @dataclass
-class PipecatSessionArguments(SessionArguments):
+class PipecatSessionArguments(RunnerArguments, SessionArguments):
     """Standard Pipecat Cloud agent session arguments.
 
-    The arguments are received by the bot() entry point.
+    Inherits from RunnerArguments for compatibility with pipecat-ai runner.
+    When pipecat-ai is not installed, uses a fallback implementation (deprecated).
 
-    Parameters:
-        body (Any): The body of the request.
+    For best compatibility, install: pip install pipecatcloud[pipecat]
     """
 
     body: Any
@@ -95,6 +114,7 @@ class DailySessionArguments(DailyRunnerArguments, SessionArguments):
     """
 
     def __post_init__(self):
+        DailyRunnerArguments.__post_init__(self)
         _warn_standalone_usage()
 
 
@@ -109,4 +129,5 @@ class WebSocketSessionArguments(WebSocketRunnerArguments, SessionArguments):
     """
 
     def __post_init__(self):
+        WebSocketRunnerArguments.__post_init__(self)
         _warn_standalone_usage()

{pipecatcloud-0.2.1 → pipecatcloud-0.2.2}/src/pipecatcloud/cli/commands/agent.py

@@ -220,7 +220,14 @@ async def sessions(
     ),
 ):
     org = organization or config.get("org")
-    agent_name = agent_name or deploy_config.agent_name
+    
+    # Get agent name from argument or deploy config
+    if not agent_name:
+        if deploy_config and deploy_config.agent_name:
+            agent_name = deploy_config.agent_name
+        else:
+            console.error("No target agent name provided")
+            return typer.Exit(1)
 
     with Live(
         console.status(f"[dim]Looking up agent with name '{agent_name}'[/dim]", spinner="dots")
@@ -257,9 +264,10 @@ async def sessions(
         bot_start_metrics = calculate_percentiles(bot_start_times)
         duration_metrics = calculate_percentiles(durations)
         cold_starts_count = sum(1 for s in sessions_list if s.get("coldStart") is True)
-        cold_start_percent = cold_starts_count / total_sessions * 100
+        metric_renderables = []  # Initialize to empty list for type consistency
 
         if duration_metrics and bot_start_metrics and total_sessions > 0:
+            cold_start_percent = cold_starts_count / total_sessions * 100
             metric_renderables = [
                 Panel(
                     f"[bold]Total Sessions:[/bold]\n{total_sessions}\n ",
@@ -289,6 +297,11 @@ async def sessions(
         table.add_column("Cold Start")
 
         for session in data.get("sessions", []):
+            # Note: session["sessionId"] is accessed without defensive checks.
+            # If the API returns malformed data missing sessionId, the CLI will crash with
+            # a KeyError rather than silently skip sessions. This ensures smoke tests and
+            # API verification catch breaking changes immediately. We could instead use
+            # console.error() and skip the session but its unclear if thats better..
             if session_id and session["sessionId"] != session_id:
                 continue
 

{pipecatcloud-0.2.1 → pipecatcloud-0.2.2/src/pipecatcloud.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pipecatcloud
-Version: 0.2.1
+Version: 0.2.2
 Summary: Cloud hosting for Pipecat AI applications
 License: BSD 2-Clause License
 Project-URL: Website, https://docs.pipecat.daily.co/
@@ -11,14 +11,14 @@ License-File: LICENSE
 Requires-Dist: aiohttp<4.0.0,>=3.11.12
 Requires-Dist: fastapi<0.117.0,>=0.115.6
 Requires-Dist: loguru~=0.7.3
-Requires-Dist: python-dotenv~=1.0.1
-Requires-Dist: uvicorn~=0.32.0
-Requires-Dist: typer~=0.15.3
+Requires-Dist: python-dotenv<2.0.0,>=1.0.1
+Requires-Dist: uvicorn<1.0.0,>=0.32.0
+Requires-Dist: typer<0.17.0,>=0.15.3
 Requires-Dist: synchronicity~=0.7.6
 Requires-Dist: toml~=0.10.2
 Requires-Dist: questionary~=2.1.0
 Provides-Extra: pipecat
-Requires-Dist: pipecat-ai>=0.0.77; extra == "pipecat"
+Requires-Dist: pipecat-ai>=0.0.79; extra == "pipecat"
 Dynamic: license-file
 
 <h1><div align="center">

{pipecatcloud-0.2.1 → pipecatcloud-0.2.2}/src/pipecatcloud.egg-info/SOURCES.txt

@@ -5,6 +5,7 @@ README.md
 dev-requirements.txt
 pipecat-cloud.png
 pyproject.toml
+pytest.ini
 .github/workflows/publish-pypi.yml
 .github/workflows/publish-test.yml
 .github/workflows/python-publish.yml
@@ -40,4 +41,6 @@ src/pipecatcloud/cli/commands/deploy.py
 src/pipecatcloud/cli/commands/init.py
 src/pipecatcloud/cli/commands/organizations.py
 src/pipecatcloud/cli/commands/run.py
-src/pipecatcloud/cli/commands/secrets.py
+src/pipecatcloud/cli/commands/secrets.py
+tests/__init__.py
+tests/test_agent_sessions.py

{pipecatcloud-0.2.1 → pipecatcloud-0.2.2}/src/pipecatcloud.egg-info/requires.txt

@@ -1,12 +1,12 @@
 aiohttp<4.0.0,>=3.11.12
 fastapi<0.117.0,>=0.115.6
 loguru~=0.7.3
-python-dotenv~=1.0.1
-uvicorn~=0.32.0
-typer~=0.15.3
+python-dotenv<2.0.0,>=1.0.1
+uvicorn<1.0.0,>=0.32.0
+typer<0.17.0,>=0.15.3
 synchronicity~=0.7.6
 toml~=0.10.2
 questionary~=2.1.0
 
 [pipecat]
-pipecat-ai>=0.0.77
+pipecat-ai>=0.0.79

pipecatcloud-0.2.2/tests/__init__.py

@@ -0,0 +1 @@
+# Test package for pipecatcloud

pipecatcloud-0.2.2/tests/test_agent_sessions.py

@@ -0,0 +1,70 @@
+"""
+Unit tests for the 'pcc agent sessions' command.
+
+Tests focus on core behaviors and edge cases, not implementation details.
+"""
+
+import pytest
+from unittest.mock import patch
+import typer
+
+# Import the function under test from local source
+from src.pipecatcloud.cli.commands.agent import sessions
+
+# Test constants
+TEST_ORG = "test-org"
+TEST_AGENT = "test-agent"
+
+
+class TestAgentSessionsCommand:
+    """Test the 'pcc agent sessions' command behaviors."""
+
+    @pytest.fixture
+    def mock_api(self):
+        """Mock the underlying API agent_sessions method."""
+        with patch('src.pipecatcloud.cli.commands.agent.API._agent_sessions') as mock_api:
+            yield mock_api
+
+    def test_handles_zero_sessions_without_crash(self, mock_api):
+        """Agent with zero sessions should not cause ZeroDivisionError."""
+        # Arrange: API returns empty sessions list
+        empty_sessions_response = {"sessions": []}
+        mock_api.return_value = empty_sessions_response
+        
+        # Act & Assert: Should complete without ZeroDivisionError
+        sessions(
+            deploy_config=None,
+            agent_name=TEST_AGENT,
+            session_id=None, 
+            organization=TEST_ORG
+        )
+
+    def test_handles_api_error_gracefully(self, mock_api):
+        """API errors should be handled without crashing.""" 
+        # Arrange: _agent_sessions raises exception (API error)
+        mock_api.side_effect = Exception("Agent not found")
+        
+        # Act: Call with API error  
+        result = sessions(
+            deploy_config=None,
+            agent_name="nonexistent-agent",
+            session_id=None,
+            organization=TEST_ORG
+        )
+        
+        # Assert: Should return typer.Exit on error
+        assert isinstance(result, type(typer.Exit()))
+
+    def test_handles_missing_agent_name_gracefully(self):
+        """Command should exit gracefully when no agent name is provided."""
+        # Act: Call with no agent name from either source
+        result = sessions(
+            deploy_config=None,  # No deploy config
+            agent_name=None,     # No agent name argument
+            session_id=None,
+            organization=TEST_ORG
+        )
+        
+        # Assert: Should return typer.Exit(1) with error message
+        assert isinstance(result, type(typer.Exit()))
+        assert result.exit_code == 1