pipecatcloud 0.1.8__tar.gz → 0.2.1__tar.gz

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

@@ -7,6 +7,40 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+
+##  [0.2.1] - 2025-08-02
+
+### Added
+
+- Added a `pipecatcloud[pipecat]` extra for installing `pipecat-ai` dependency.
+
+### Changed
+
+- Session argument types now inherit from pipecat-ai runner types when available.
+  `DailySessionArguments` and `WebSocketSessionArguments` now inherit from
+  `pipecat.runner.types` when `pipecat-ai>=0.0.77` is installed to provide
+  compatibility with the pipecat-ai development runner.
+
+- Add clarifying information to the `pcc secrets image-pull-secret` setup.
+
+- Modified the `aiohttp` minimum version to `3.11.12` and expanded `fastapi` to
+  `>=0.115.6,<0.117.0` in order to align with `pipecat-ai`.
+
+### Deprecated
+
+- When `pipecat-ai` is not installed, session arguments fall back to standalone
+  implementations. This fallback behavior is deprecated and will be removed in
+  a future version. Install with `pip install pipecatcloud[pipecat]` for the
+  preferred implementation.
+
+## [0.2.0] - 2025-07-09
+
+### Changed
+
+- `deploy` command now requires valid image pull credentials (`--credentials`). Most repositories and use-cases require authorized image pulls, so this change aims to guide correct usage.
+  - Deploying without credentials can be achieved with the `--no-credentials` / `-nc` or `--force` flags.
+  - It is always recommend to provide a an image pull secret as part of your deployment.
+
 ## [0.1.8] - 2025-07-09
 
 ### Changed

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pipecatcloud
-Version: 0.1.8
+Version: 0.2.1
 Summary: Cloud hosting for Pipecat AI applications
 License: BSD 2-Clause License
 Project-URL: Website, https://docs.pipecat.daily.co/
@@ -8,8 +8,8 @@ Keywords: pipecat,pipecat-ai,voice,ai,llm
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: aiohttp<4.0.0,~=3.11.13
-Requires-Dist: fastapi~=0.115.6
+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
@@ -17,6 +17,8 @@ Requires-Dist: typer~=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"
 Dynamic: license-file
 
 <h1><div align="center">

pipecatcloud-0.2.1/dev-requirements.txt

@@ -0,0 +1,8 @@
+build~=1.2.2
+grpcio-tools~=1.67.1
+pip-tools~=7.4.1
+pyright~=1.1.402
+pytest~=8.4.1
+ruff~=0.12.1
+setuptools~=78.1.1
+setuptools_scm~=8.3.1

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

@@ -4,15 +4,15 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pipecatcloud"
-version = "0.1.8"
+version = "0.2.1"
 requires-python = ">=3.10"
 description = "Cloud hosting for Pipecat AI applications"
 license = { text = "BSD 2-Clause License" }
 readme = "README.md"
 keywords = ["pipecat", "pipecat-ai", "voice", "ai", "llm"]
 dependencies = [
-    "aiohttp~=3.11.13,<4.0.0",
-    "fastapi~=0.115.6",
+    "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",
@@ -22,6 +22,9 @@ dependencies = [
     "questionary~=2.1.0"
 ]
 
+[project.optional-dependencies]
+pipecat = ["pipecat-ai>=0.0.77"]
+
 [project.scripts]
 pcc = "pipecatcloud.__main__:main"
 pipecatcloud = "pipecatcloud.__main__:main"

pipecatcloud-0.2.1/src/pipecatcloud/agent.py

@@ -0,0 +1,112 @@
+#
+# Copyright (c) 2025, Daily
+#
+# SPDX-License-Identifier: BSD 2-Clause License
+#
+
+import warnings
+from dataclasses import dataclass
+from typing import Any, Optional
+
+from fastapi import WebSocket
+
+# Try to import new types from pipecat-ai
+try:
+    from pipecat.runner.types import (
+        DailyRunnerArguments,
+        WebSocketRunnerArguments,
+    )
+
+    _PIPECAT_RUNNER_TYPES_AVAILABLE = True
+except ImportError:
+    _PIPECAT_RUNNER_TYPES_AVAILABLE = False
+
+    # Fallback definitions
+    @dataclass
+    class DailyRunnerArguments:
+        """Fallback Daily runner arguments when pipecat-ai not available.
+
+        .. deprecated:: 0.2.1
+            Install pipecatcloud[pipecat] for better compatibility.
+        """
+
+        room_url: str
+        token: str
+        body: Any
+
+    @dataclass
+    class WebSocketRunnerArguments:
+        """Fallback WebSocket runner arguments when pipecat-ai not available.
+
+        .. deprecated:: 0.2.1
+            Install pipecatcloud[pipecat] for better compatibility.
+        """
+
+        websocket: WebSocket
+
+
+def _warn_standalone_usage():
+    """Warn users about standalone session arguments usage."""
+    if not _PIPECAT_RUNNER_TYPES_AVAILABLE:
+        warnings.warn(
+            "Using standalone pipecatcloud session arguments without pipecat-ai. "
+            "For better compatibility, install: pip install pipecatcloud[pipecat]. "
+            "Standalone mode will be removed in a future release.",
+            DeprecationWarning,
+            stacklevel=3,
+        )
+
+
+@dataclass
+class SessionArguments:
+    """Base class for common agent session arguments.
+
+    The arguments are received by the bot() entry point.
+
+    Parameters:
+        session_id (Optional[str]): The unique identifier for the session.
+            This is used to track the session across requests.
+    """
+
+    session_id: Optional[str]
+
+
+@dataclass
+class PipecatSessionArguments(SessionArguments):
+    """Standard Pipecat Cloud agent session arguments.
+
+    The arguments are received by the bot() entry point.
+
+    Parameters:
+        body (Any): The body of the request.
+    """
+
+    body: Any
+
+
+@dataclass
+class DailySessionArguments(DailyRunnerArguments, SessionArguments):
+    """Daily based agent session arguments.
+
+    Inherits from DailyRunnerArguments for compatibility with pipecat-ai runner.
+    When pipecat-ai is not installed, uses a fallback implementation (deprecated).
+
+    For best compatibility, install: pip install pipecatcloud[pipecat]
+    """
+
+    def __post_init__(self):
+        _warn_standalone_usage()
+
+
+@dataclass
+class WebSocketSessionArguments(WebSocketRunnerArguments, SessionArguments):
+    """WebSocket based agent session arguments.
+
+    Inherits from WebSocketRunnerArguments for compatibility with pipecat-ai runner.
+    When pipecat-ai is not installed, uses a fallback implementation (deprecated).
+
+    For best compatibility, install: pip install pipecatcloud[pipecat]
+    """
+
+    def __post_init__(self):
+        _warn_standalone_usage()

{pipecatcloud-0.1.8 → pipecatcloud-0.2.1}/src/pipecatcloud/cli/commands/deploy.py

@@ -286,6 +286,13 @@ def create_deploy_command(app: typer.Typer):
             help="Force deployment / skip confirmation",
             rich_help_panel="Additional Options",
         ),
+        no_credentials: bool = typer.Option(
+            False,
+            "--no-credentials",
+            "-nc",
+            help="Deployment will not require an image pull secret",
+            rich_help_panel="Additional Options",
+        ),
         # @deprecated
         min_instances: int = typer.Option(
             None,
@@ -348,24 +355,15 @@ def create_deploy_command(app: typer.Typer):
             console.error("Image / repository URL is required")
             return typer.Exit()
 
-        # Show a warning if no credentials are provided
-        if not partial_config.image_credentials and not skip_confirm:
-            console.print(
-                Panel(
-                    "[yellow]You are attempting to deploy an agent image without an image pull secret."
-                    "\n\nUse [bold][--credentials][/bold] to provide a image pull secret."
-                    "\n\nPlease be aware that future versions of the Pipecat Cloud CLI will require credentials for all deployments (unless forced manually).",
-                    title="[bold yellow]Warning: Deploying without credentials[/bold yellow]",
-                    title_align="left",
-                    subtitle_align="left",
-                    subtitle="[dim]Learn more: https://docs.pipecat.daily.co/agents/secrets#image-pull-secrets[/dim]",
-                    border_style="yellow",
-                ))
-            if not typer.confirm(
-                "Are you sure you want to deploy without an image pull secret?",
-                default=False,
-            ):
-                return typer.Exit()
+        # Assert credentials are provided if not using --no-credentials / force flag
+        if not no_credentials and not partial_config.image_credentials and not skip_confirm:
+            console.error(
+                "Deployments require an image pull secret [bold](--credentials)[/bold] to securely pull images from private repositories."
+                "\nPlease provide an image pull secret name or use [bold][--no-credentials][/bold] to deploy without one.",
+                subtitle="Learn more:https://docs.pipecat.daily.co/agents/secrets#image-pull-secrets",
+                title_extra="Attempt to deploy without repository credentials",
+            )
+            return typer.Exit()
 
         # Create and display table
         table = Table(show_header=False, border_style="dim", show_edge=True, show_lines=True)

{pipecatcloud-0.1.8 → pipecatcloud-0.2.1}/src/pipecatcloud/cli/commands/secrets.py

@@ -471,8 +471,14 @@ async def image_pull_secret(
         return typer.Exit(1)
 
     if not credentials:
+        console.print(
+            "[cyan]For more information about image pull secrets, see: "
+            "https://docs.pipecat.daily.co/agents/secrets#image-pull-secrets[/cyan]\n"
+        )
         username = await questionary.text(f"Username for image repository '{host}'").ask_async()
-        password = await questionary.password(f"Password for image repository '{host}'").ask_async()
+        password = await questionary.password(
+            f"Access token for image repository '{host}'"
+        ).ask_async()
         if not username or not password:
             console.print("[bold red]Image pull secret creation cancelled[/bold red]")
             return typer.Exit(1)

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pipecatcloud
-Version: 0.1.8
+Version: 0.2.1
 Summary: Cloud hosting for Pipecat AI applications
 License: BSD 2-Clause License
 Project-URL: Website, https://docs.pipecat.daily.co/
@@ -8,8 +8,8 @@ Keywords: pipecat,pipecat-ai,voice,ai,llm
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: aiohttp<4.0.0,~=3.11.13
-Requires-Dist: fastapi~=0.115.6
+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
@@ -17,6 +17,8 @@ Requires-Dist: typer~=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"
 Dynamic: license-file
 
 <h1><div align="center">

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

@@ -1,5 +1,5 @@
-aiohttp<4.0.0,~=3.11.13
-fastapi~=0.115.6
+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
@@ -7,3 +7,6 @@ typer~=0.15.3
 synchronicity~=0.7.6
 toml~=0.10.2
 questionary~=2.1.0
+
+[pipecat]
+pipecat-ai>=0.0.77

pipecatcloud-0.1.8/dev-requirements.txt

@@ -1,8 +0,0 @@
-build~=1.2.1
-grpcio-tools~=1.62.2
-pip-tools~=7.4.1
-pyright~=1.1.376
-pytest~=8.3.2
-ruff~=0.6.7
-setuptools~=72.2.0
-setuptools_scm~=8.1.0

pipecatcloud-0.1.8/src/pipecatcloud/agent.py

@@ -1,52 +0,0 @@
-#
-# Copyright (c) 2025, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-from dataclasses import dataclass
-from typing import Any, Optional
-
-from fastapi import WebSocket
-
-
-@dataclass
-class SessionArguments:
-    """Base class for common agent session arguments. The arguments are received
-    by the bot() entry point.
-
-    """
-
-    session_id: Optional[str]
-
-
-@dataclass
-class PipecatSessionArguments(SessionArguments):
-    """Standard Pipecat Cloud agent session arguments. The arguments are
-    received by the bot() entry point.
-
-    """
-
-    body: Any
-
-
-@dataclass
-class DailySessionArguments(SessionArguments):
-    """Daily based agent session arguments. The arguments are received by the
-    bot() entry point.
-
-    """
-
-    room_url: str
-    token: str
-    body: Any
-
-
-@dataclass
-class WebSocketSessionArguments(SessionArguments):
-    """Websocket based agent session arguments. The arguments are received by
-    the bot() entry point.
-
-    """
-
-    websocket: WebSocket