pipecatcloud 0.2.6__tar.gz → 0.2.8__tar.gz

{pipecatcloud-0.2.6 → pipecatcloud-0.2.8}/CHANGELOG.md

@@ -5,6 +5,29 @@ 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.8] - 2025-10-24
+
+### Added
+
+- Register pipecat cloud commands as `pipecat-cli` extensions.
+
+## [0.2.7] - 2025-10-21
+
+### Added
+
+- Added a `stop` command to `pcc agent` that allows stopping an ongoing Pipecat
+  Cloud session.
+
+### Changed
+
+- Fallback `RunnerArguments` now include a `body` field in the base class.
+
+### Deprecated
+
+- The `pcc init` command is now deprecated and will be removed in a future
+  version. Use the [Pipecat CLI](https://github.com/pipecat-ai/pipecat-cli)
+  instead.
+
 ## [0.2.6] - 2025-10-09
 
 ### Added

{pipecatcloud-0.2.6/src/pipecatcloud.egg-info → pipecatcloud-0.2.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pipecatcloud
-Version: 0.2.6
+Version: 0.2.8
 Summary: Cloud hosting for Pipecat AI applications
 License: BSD 2-Clause License
 Project-URL: Website, https://docs.pipecat.daily.co/

{pipecatcloud-0.2.6 → pipecatcloud-0.2.8}/pyproject.toml

@@ -42,6 +42,9 @@ dev = [
 pcc = "pipecatcloud.__main__:main"
 pipecatcloud = "pipecatcloud.__main__:main"
 
+[project.entry-points."pipecat_cli.extensions"]
+cloud = "pipecatcloud.cli.entry_point:entrypoint_cli_typer"
+
 [tool.setuptools]
 package-dir = {"" = "src"}
 

{pipecatcloud-0.2.6 → pipecatcloud-0.2.8}/src/pipecatcloud/agent.py

@@ -15,8 +15,8 @@ try:
     from pipecat.runner.types import (
         DailyRunnerArguments,
         RunnerArguments,
-        WebSocketRunnerArguments,
         SmallWebRTCRunnerArguments,
+        WebSocketRunnerArguments,
     )
 
     _PIPECAT_RUNNER_TYPES_AVAILABLE = True
@@ -33,9 +33,10 @@ except ImportError:
             will be removed in a future release.
         """
 
-        handle_sigint: bool = field(init=False)
-        handle_sigterm: bool = field(init=False)
-        pipeline_idle_timeout_secs: int = field(init=False)
+        handle_sigint: bool = field(init=False, kw_only=True)
+        handle_sigterm: bool = field(init=False, kw_only=True)
+        pipeline_idle_timeout_secs: int = field(init=False, kw_only=True)
+        body: Optional[Any] = field(default_factory=dict, kw_only=True)
 
         def __post_init__(self):
             self.handle_sigint = False
@@ -52,7 +53,6 @@ except ImportError:
 
         room_url: str
         token: str
-        body: Any
 
     @dataclass
     class WebSocketRunnerArguments(RunnerArguments):
@@ -63,7 +63,6 @@ except ImportError:
         """
 
         websocket: WebSocket
-        body: Any
 
     @dataclass
     class SmallWebRTCRunnerArguments(RunnerArguments):
@@ -112,7 +111,9 @@ class PipecatSessionArguments(RunnerArguments, SessionArguments):
     For best compatibility, install: pip install pipecatcloud[pipecat]
     """
 
-    body: Any
+    def __post_init__(self):
+        RunnerArguments.__post_init__(self)
+        _warn_standalone_usage()
 
 
 @dataclass
@@ -144,6 +145,7 @@ class WebSocketSessionArguments(WebSocketRunnerArguments, SessionArguments):
         WebSocketRunnerArguments.__post_init__(self)
         _warn_standalone_usage()
 
+
 @dataclass
 class SmallWebRTCSessionArguments(SmallWebRTCRunnerArguments, SessionArguments):
     """SmallWebRTCTransport based agent session arguments.

{pipecatcloud-0.2.6 → pipecatcloud-0.2.8}/src/pipecatcloud/api.py

@@ -438,3 +438,17 @@ class _API:
     @property
     def agent_sessions(self):
         return self.create_api_method(self._agent_sessions)
+
+    async def _agent_session_terminate(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("DELETE", url, not_found_is_empty=True)
+
+    @property
+    def agent_session_terminate(self):
+        """Terminate an active session for an agent.
+        Args:
+            agent_name: Name of the agent
+            session_id: ID of the session to terminate
+            org: Organization ID
+        """
+        return self.create_api_method(self._agent_session_terminate)

{pipecatcloud-0.2.6 → pipecatcloud-0.2.8}/src/pipecatcloud/cli/commands/agent.py

@@ -730,3 +730,70 @@ async def start(
                 url = f"{daily_room}?t={daily_token}"
                 console.print("\nJoin your session by visiting the link below:")
                 console.print(f"[link={url}]{url}[/link]")
+
+
+@agent_cli.command(name="stop", help="Stop an active agent session")
+@synchronizer.create_blocking
+@requires_login
+@with_deploy_config
+async def stop(
+    deploy_config=typer.Option(None, hidden=True),
+    agent_name: str = typer.Argument(None, help="Name of the agent e.g. 'my-agent'"),
+    session_id: str = typer.Option(
+        ...,
+        "--session-id",
+        "-s",
+        help="ID of the session to stop",
+    ),
+    organization: str = typer.Option(
+        None, "--organization", "-o", help="Organization which the agent belongs to"
+    ),
+    force: bool = typer.Option(
+        False,
+        "--force",
+        "-f",
+        help="Bypass prompt for confirmation",
+    ),
+):
+    org = organization or config.get("org")
+
+    # Load values from deployment config file (if one exists)
+    partial_config = deploy_config or DeployConfigParams()
+
+    # Get agent name from argument or deploy config
+    if not agent_name:
+        if partial_config and partial_config.agent_name:
+            agent_name = partial_config.agent_name
+        else:
+            console.error("No target agent name provided")
+            return typer.Exit(1)
+
+    # Confirm stop request
+    if not force:
+        console.print(
+            Panel(
+                f"Agent Name: {agent_name}\n"
+                f"Session ID: {session_id}",
+                title=f"[bold]Stop Session[/bold]",
+                title_align="left",
+                border_style="yellow",
+            )
+        )
+        if not await questionary.confirm(
+            "Are you sure you want to stop this session?"
+        ).ask_async():
+            console.print("[bold]Aborting stop request[/bold]")
+            return typer.Exit(1)
+
+    with console.status(
+        f"[dim]Stopping session [bold]'{session_id}'[/bold] for agent [bold]'{agent_name}'[/bold][/dim]",
+        spinner="dots",
+    ):
+        data, error = await API.agent_session_terminate(
+            agent_name=agent_name, session_id=session_id, org=org
+        )
+
+        if error:
+            return typer.Exit(1)
+
+        console.success(f"Session '{session_id}' stopped successfully")

{pipecatcloud-0.2.6 → pipecatcloud-0.2.8}/src/pipecatcloud/cli/commands/docker.py

@@ -336,7 +336,7 @@ async def build_push(
         console.print("\n[dim]To deploy this image, update your pcc-deploy.toml:[/dim]")
         console.print(f'  [bold]image = "{version_tag}"[/bold]')
         console.print("\n[dim]Then run:[/dim]")
-        console.print("  [bold]pipecatcloud deploy[/bold]")
+        console.print("  [bold]pipecat cloud deploy[/bold]")
 
 
 def create_docker_command(app: typer.Typer):

{pipecatcloud-0.2.6 → pipecatcloud-0.2.8}/src/pipecatcloud/cli/commands/init.py

@@ -5,6 +5,7 @@
 #
 
 import os
+import warnings
 import zipfile
 from typing import Set
 
@@ -40,9 +41,25 @@ def check_existing_files() -> Set[str]:
 
 
 def create_init_command(app: typer.Typer):
-    @app.command(name="init", help="Initialize project directory with template files")
+    @app.command(
+        name="init",
+        help="[DEPRECATED] Initialize project directory with template files",
+        deprecated=True,
+    )
     @synchronizer.create_blocking
     async def init():
+        warnings.warn(
+            "The 'pcc init' command is deprecated and will be removed in a future version. "
+            "Please use the Pipecat CLI instead: https://github.com/pipecat-ai/pipecat-cli",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        console.print(
+            "[yellow]Warning:[/yellow] The 'pcc init' command is deprecated and will be removed in a future version.\n"
+            "Please use the Pipecat CLI instead: "
+            "[link=https://github.com/pipecat-ai/pipecat-cli]https://github.com/pipecat-ai/pipecat-cli[/link]"
+        )
+
         if not await questionary.confirm(
             "This will download the latest starter project to the current directory. Continue?"
         ).ask_async():

{pipecatcloud-0.2.6 → pipecatcloud-0.2.8/src/pipecatcloud.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pipecatcloud
-Version: 0.2.6
+Version: 0.2.8
 Summary: Cloud hosting for Pipecat AI applications
 License: BSD 2-Clause License
 Project-URL: Website, https://docs.pipecat.daily.co/

{pipecatcloud-0.2.6 → pipecatcloud-0.2.8}/src/pipecatcloud.egg-info/SOURCES.txt

@@ -45,5 +45,6 @@ src/pipecatcloud/cli/commands/secrets.py
 src/pipecatcloud/smallwebrtc/session_manager.py
 tests/__init__.py
 tests/test_agent_sessions.py
+tests/test_agent_stop.py
 tests/test_docker_commands.py
 tests/test_managed_keys.py

{pipecatcloud-0.2.6 → pipecatcloud-0.2.8}/src/pipecatcloud.egg-info/entry_points.txt

@@ -1,3 +1,6 @@
 [console_scripts]
 pcc = pipecatcloud.__main__:main
 pipecatcloud = pipecatcloud.__main__:main
+
+[pipecat_cli.extensions]
+cloud = pipecatcloud.cli.entry_point:entrypoint_cli_typer

pipecatcloud-0.2.8/tests/test_agent_stop.py

@@ -0,0 +1,99 @@
+"""
+Unit tests for the 'pcc agent stop' command.
+
+Tests focus on core behaviors and edge cases, not implementation details.
+"""
+
+import pytest
+import typer
+from unittest.mock import patch, AsyncMock, MagicMock
+
+# Import the function under test from local source
+from src.pipecatcloud.cli.commands.agent import stop
+
+# Test constants
+TEST_ORG = "test-org"
+TEST_AGENT = "test-agent"
+TEST_SESSION_ID = "session-123"
+
+
+class TestAgentStopCommand:
+    """Test the 'pcc agent stop' command behaviors."""
+
+    def test_stop_respects_force_flag(self):
+        """Verify force flag skips confirmation when set to True."""
+        with patch('src.pipecatcloud.cli.commands.agent.console') as mock_console, \
+             patch('src.pipecatcloud.cli.commands.agent.config') as mock_config, \
+             patch('src.pipecatcloud.cli.commands.agent.questionary') as mock_questionary, \
+             patch('src.pipecatcloud.cli.commands.agent.DeployConfigParams') as mock_params:
+
+            mock_config.get.return_value = TEST_ORG
+            mock_params.return_value = MagicMock(agent_name=TEST_AGENT)
+            # Mock questionary - should NOT be called when force=True
+            mock_questionary.confirm.return_value.ask_async = AsyncMock()
+
+            # Act with force=True
+            stop(
+                deploy_config=None,
+                agent_name=TEST_AGENT,
+                session_id=TEST_SESSION_ID,
+                organization=TEST_ORG,
+                force=True,
+            )
+
+            # Assert
+            # questionary.confirm should not be called when force=True
+            mock_questionary.confirm.assert_not_called()
+
+    def test_stop_shows_confirmation_without_force(self):
+        """Verify confirmation prompt is shown when force is False."""
+        with patch('src.pipecatcloud.cli.commands.agent.console') as mock_console, \
+             patch('src.pipecatcloud.cli.commands.agent.config') as mock_config, \
+             patch('src.pipecatcloud.cli.commands.agent.questionary') as mock_questionary, \
+             patch('src.pipecatcloud.cli.commands.agent.DeployConfigParams') as mock_params:
+
+            mock_config.get.return_value = TEST_ORG
+            mock_params.return_value = MagicMock(agent_name=TEST_AGENT)
+            # User agrees to the confirmation
+            mock_questionary.confirm.return_value.ask_async = AsyncMock(return_value=True)
+
+            # Act with force=False
+            stop(
+                deploy_config=None,
+                agent_name=TEST_AGENT,
+                session_id=TEST_SESSION_ID,
+                organization=TEST_ORG,
+                force=False,
+            )
+
+            # Assert
+            # questionary.confirm should be called when force=False
+            mock_questionary.confirm.assert_called_once()
+
+    def test_stop_aborts_on_user_rejection(self):
+        """Verify command aborts when user rejects the confirmation."""
+        with patch('src.pipecatcloud.cli.commands.agent.console') as mock_console, \
+             patch('src.pipecatcloud.cli.commands.agent.config') as mock_config, \
+             patch('src.pipecatcloud.cli.commands.agent.questionary') as mock_questionary, \
+             patch('src.pipecatcloud.cli.commands.agent.DeployConfigParams') as mock_params:
+
+            mock_config.get.return_value = TEST_ORG
+            mock_params.return_value = MagicMock(agent_name=TEST_AGENT)
+            # User rejects the confirmation
+            mock_questionary.confirm.return_value.ask_async = AsyncMock(return_value=False)
+
+            # Act
+            result = stop(
+                deploy_config=None,
+                agent_name=TEST_AGENT,
+                session_id=TEST_SESSION_ID,
+                organization=TEST_ORG,
+                force=False,
+            )
+
+            # Assert
+            # Should exit with code 1 (abort)
+            assert isinstance(result, typer.Exit)
+            assert result.exit_code == 1
+            # Should display abort message
+            mock_console.print.assert_any_call("[bold]Aborting stop request[/bold]")