pipecatcloud 0.0.9__tar.gz → 0.0.11__tar.gz

{pipecatcloud-0.0.9 → pipecatcloud-0.0.11/.github/workflows}/publish-pypi.yml

@@ -39,7 +39,7 @@ jobs:
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install -r requirements.txt
+          pip install -r dev-requirements.txt
           pip install build twine
 
       - name: Build package

{pipecatcloud-0.0.9 → pipecatcloud-0.0.11/.github/workflows}/publish-test.yml

@@ -39,7 +39,7 @@ jobs:
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install -r requirements.txt
+          pip install -r dev-requirements.txt
           pip install build twine
 
       - name: Build package

{pipecatcloud-0.0.9 → pipecatcloud-0.0.11}/.github/workflows/python-publish.yml

@@ -38,40 +38,3 @@ jobs:
         with:
           name: release-dists
           path: dist/
-
-  pypi-publish:
-    runs-on: ubuntu-latest
-    needs:
-      - release-build
-    permissions:
-      id-token: write
-      contents: read
-
-    environment:
-      name: pypi
-      url: https://pypi.org/p/pipecat-cloud
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Retrieve release distributions
-        uses: actions/download-artifact@v4
-        with:
-          name: release-dists
-          path: dist/
-
-      - name: Publish release distributions to PyPI
-        uses: pypa/gh-action-pypi-publish@release/v1
-        with:
-          packages-dir: dist/
-
-      - name: Create GitHub Release
-        uses: softprops/action-gh-release@v2
-        with:
-          tag_name: ${{ github.ref }}
-          name: Release ${{ github.ref_name }}
-          draft: false
-          prerelease: false
-          files: |
-            dist/*.tar.gz
-            dist/*.whl

{pipecatcloud-0.0.9 → pipecatcloud-0.0.11}/CHANGELOG.md

@@ -5,84 +5,184 @@ 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.0.11] - 2025-03-04
+
+### Changed
+
+- `session.py` now returns the response body from the `start()` method.
+
+### Fixed
+
+- Fixed an issue in `session.py` where a bot wouldn't start due to malformed
+  `data`.
+
+## [0.0.10] - 2025-03-04
+
+### Added
+
+- `init` convenience command will now populate the working directory with files
+  from the starter project.
+
+- `agent log` allows for optional severity level filtering.
+
+### Changed
+
+- `agent status` and `deploy` no longer show superfluous data.
+
+- `session.py` now correctly handles errors when starting agents.
+
+- `secrets set` no longer prompts twice for confirmation if the secret set does
+  not exist.
+
+### Removed
+
+- `errors.py` removed as redundant (error message and code returned via API).
+
+- `agent_utils.py` removed as redundant (error message and code returned via
+  API).
+
 ## [0.0.9] - 2025-02-27
 
 ### Added
-- `agent status [agent-name]` now shows deployment info and scaling configuration
-- `agent sessions [agent-name]` lists active session count for an agent (will list session details in future)
-- `agent start [agent-name] -D` now shows the Daily room URL (and token) to join in the terminal output
+
+- `agent status [agent-name]` now shows deployment info and scaling
+  configuration.
+
+- `agent sessions [agent-name]` lists active session count for an agent (will
+  list session details in future).
+
+- `agent start [agent-name] -D` now shows the Daily room URL (and token) to
+  join in the terminal output.
 
 ### Changed
-- Changed CLI command from `pipecat` to `pipecatcloud` or `pcc`
-- `agent delete` prompts the user for confirmation first
-- `agent start` now checks the target deployment first to ensure it exists and is in a healthy state
-- Changed the information order of `agent status` so the health badge is clearly visible in terminal
-- `agent deploy` now defaults to "Y" for the confirmation prompts
+
+- Changed CLI command from `pipecat` to `pipecatcloud` or `pcc`.
+
+- `agent delete` prompts the user for confirmation first.
+
+- `agent start` now checks the target deployment first to ensure it exists and
+  is in a healthy state.
+
+- Changed the information order of `agent status` so the health badge is
+  clearly visible in terminal.
+
+- `agent deploy` now defaults to "Y" for the confirmation prompts.
 
 ### Fixed
-- Fixed lint error with payload data in `agent start`
-- Fixed a bug where `pcc-deploy.toml` files were required to be present
-- `deploy` command now correctly passes the secret set to the deployment from the `pcc-deploy.toml` file
+
+- Fixed lint error with payload data in `agent start`.
+
+- Fixed a bug where `pcc-deploy.toml` files were required to be present.
+
+- `deploy` command now correctly passes the secret set to the deployment from
+  the `pcc-deploy.toml` file.
 
 ## [0.0.8] - 2025-02-03
 
 ### Added
-- `secrets set [set-name] --file` allowing you to create a secret set from .env file
-- `agent scale` to modify agent configuration without pushing a new image
-- `run` command for running bot.py files locally via FastAPI. This initial implementation is very basic and will be expanded in the future.
-- `organizations select` allows passing an `--org / -o` option to bypass prompt
+
+- `secrets set [set-name] --file` allowing you to create a secret set from .env
+  file.
+
+- `agent scale` to modify agent configuration without pushing a new image.
+
+- `run` command for running bot.py files locally via FastAPI. This initial
+  implementation is very basic and will be expanded in the future.
+
+- `organizations select` allows passing an `--org / -o` option to bypass
+  prompt.
 
 ### Fixed
-- All commands use the correct shorthand flag syntax (`-` vs. `--`)
-- CLI config extends from module config to avoid loading config TOML with package imports
-- `secrets list` now correctly lists all secrets vs. just a single entry
-- `deploy` command displays live status to prevent skewed terminal output
-- `deploy` command no longer allows pushing images without a tag
-- `agent logs` paginate / filter / sort and tidy up display for logs
-- `start` command correctly clears the live terminal text
-- `pcc-deploy.toml` files now work as intended with `deploy` command
-- `deploy` method now passes configuration parameters correctly
-- Switching organizations will fully remove any default API tokens from the previously selected organization
+
+- All commands use the correct shorthand flag syntax (`-` vs. `--`).
+
+- CLI config extends from module config to avoid loading config TOML with
+  package imports.
+
+- `secrets list` now correctly lists all secrets vs. just a single entry.
+
+- `deploy` command displays live status to prevent skewed terminal output.
+
+- `deploy` command no longer allows pushing images without a tag.
+
+- `agent logs` paginate / filter / sort and tidy up display for logs.
+
+- `start` command correctly clears the live terminal text.
+
+- `pcc-deploy.toml` files now work as intended with `deploy` command.
+
+- `deploy` method now passes configuration parameters correctly.
+
+- Switching organizations will fully remove any default API tokens from the
+  previously selected organization.
 
 ### Changed
-- Local config now retains default keys when switching between organizations
-- Local config now retains defaukt keys when logging in again
-- `deploy` will check passed secret set exists before deployment
-- `secrets list` now takes an optional `--sets / -s` parameter that filters by secret sets or image pull secrets
-- `organizations keys create` now prompts you to set the newly created key as the default after creation (if active org matches)
-- `organizations keys delete` not prompts to confirm if selected key is currently your local config default
-- `Agent` module import has been renamed to `Session` to better reflect API
 
+- Local config now retains default keys when switching between organizations.
+
+- Local config now retains defaukt keys when logging in again.
+
+- `deploy` will check passed secret set exists before deployment.
+
+- `secrets list` now takes an optional `--sets / -s` parameter that filters by
+  secret sets or image pull secrets.
+
+- `organizations keys create` now prompts you to set the newly created key as
+  the default after creation (if active org matches).
+
+- `organizations keys delete` not prompts to confirm if selected key is
+  currently your local config default.
+
+- `Agent` module import has been renamed to `Session` to better reflect API.
 
 ## [0.0.7] - 2025-02-01
 
 ### Added
 
-- `run` command for running an agent locally. This initial implementation is very basic and will be expanded in the future.
+- `run` command for running an agent locally. This initial implementation is
+  very basic and will be expanded in the future.
 
 ### Changed
 
-- `start_agent` method no longer requires an organization. If not provided, it will assume the namespace of the API token owner.
-- `start` command no longer looks up the agent before starting (health check is handled by the proxy route.)
+- `start_agent` method no longer requires an organization. If not provided, it
+  will assume the namespace of the API token owner.
+
+- `start` command no longer looks up the agent before starting (health check is
+  handled by the proxy route).
 
 ## [0.0.6] - 2025-02-01
 
 ### Added
 
-- `pipecatcloud.agent` module for working with agents via Python scripts
-    - `start_agent` method for starting an agent
+- `pipecatcloud.agent` module for working with agents via Python scripts.
+
+- `start_agent` method for starting an agent.
 
 ### Backlog
 
-- `deploy` make image pull secrets non-optional, but allow for bypassing
-- Fix: update docs to assert that the bot method must be async
-- Fix: Secrets are not upserting (overriding each time, which may be preferrable?)
-- Fix: deployment process needs better output
-- `organizations keys create` should ask if you'd like to set the created key as default after creation (if org matches)
-- Sense check image parameter of the deploy command (does it have a tag, etc)
-- `agent logs` paginate / filter / sort and tidy up display for logs
-- Fix: start command should clear the live text
-- Secrets from .env method
-- Fix: .pcc-deploy.toml should read correctly 
-- New conveience method to add account associated Daily API Key to a secret set
-- Add: concurrency support for agent deployments
+- `deploy` make image pull secrets non-optional, but allow for bypassing.
+
+- Fix: update docs to assert that the bot method must be async.
+
+- Fix: Secrets are not upserting (overriding each time, which may be.
+  preferable?).
+
+- Fix: deployment process needs better output.
+
+- `organizations keys create` should ask if you'd like to set the created key
+  as default after creation (if org matches).
+
+- Sense check image parameter of the deploy command (does it have a tag, etc).
+
+- `agent logs` paginate / filter / sort and tidy up display for logs.
+
+- Fix: start command should clear the live text.
+
+- Secrets from .env method.
+
+- Fix: .pcc-deploy.toml should read correctly.
+
+- New convenience method to add account associated Daily API Key to a secret
+  set.
+
+- Add: concurrency support for agent deployments.

{pipecatcloud-0.0.9 → pipecatcloud-0.0.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: pipecatcloud
-Version: 0.0.9
+Version: 0.0.11
 Summary: Cloud hosting for Pipecat AI applications
 License: BSD 2-Clause License
 Project-URL: Website, https://docs.pipecat.daily.co/
@@ -70,16 +70,26 @@ pcc auth login
 
 ### Usage in Python scripts
 
-If want to programmatically start an agent within a Python script, you can use the `pipecatcloud.agent` module.
+If want to programmatically start an agent within a Python script, you can use the `pipecatcloud.session` module.
 
 ```python
-from pipecatcloud.agent import Agent
-
-agent = Agent(
-    agent_name="your-agent-name",
-    organization="your-organization",
-    api_key="your-api-key",
-)
-
-await agent.start()
+from pipecatcloud.session import Session
+from pipecatcloud.exception import AgentStartError
+import asyncio
+
+async def main():
+    session = Session(
+        agent_name="your-agent-name",
+        api_key="pk_...",
+    )
+
+    try:
+        await session.start()
+    except AgentStartError as e:
+        print(e)
+    except Exception as e:
+        raise (e)
+
+if __name__ == "__main__":
+    asyncio.run(main())
 ```

{pipecatcloud-0.0.9 → pipecatcloud-0.0.11}/README.md

@@ -50,16 +50,26 @@ pcc auth login
 
 ### Usage in Python scripts
 
-If want to programmatically start an agent within a Python script, you can use the `pipecatcloud.agent` module.
+If want to programmatically start an agent within a Python script, you can use the `pipecatcloud.session` module.
 
 ```python
-from pipecatcloud.agent import Agent
-
-agent = Agent(
-    agent_name="your-agent-name",
-    organization="your-organization",
-    api_key="your-api-key",
-)
-
-await agent.start()
+from pipecatcloud.session import Session
+from pipecatcloud.exception import AgentStartError
+import asyncio
+
+async def main():
+    session = Session(
+        agent_name="your-agent-name",
+        api_key="pk_...",
+    )
+
+    try:
+        await session.start()
+    except AgentStartError as e:
+        print(e)
+    except Exception as e:
+        raise (e)
+
+if __name__ == "__main__":
+    asyncio.run(main())
 ```

{pipecatcloud-0.0.9 → pipecatcloud-0.0.11}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pipecatcloud"
-version = "0.0.9"
+version = "0.0.11"
 requires-python = ">=3.10"
 description = "Cloud hosting for Pipecat AI applications"
 license = { text = "BSD 2-Clause License" }

pipecatcloud-0.0.11/src/pipecatcloud/__init__.py

@@ -0,0 +1,39 @@
+#
+# Copyright (c) 2025, Daily
+#
+# SPDX-License-Identifier: BSD 2-Clause License
+#
+
+import os
+import sys
+
+from loguru import logger
+
+from .exception import (
+    AgentNotHealthyError,
+    AgentStartError,
+    AuthError,
+    ConfigError,
+    ConfigFileError,
+    Error,
+    InvalidError,
+)
+from .session import Session, SessionParams
+
+logger.remove()
+logger.add(sys.stderr, level=str(os.getenv("PCC_LOG_LEVEL", "INFO")))
+
+
+__all__ = [
+    # Session classes
+    "Session",
+    "SessionParams",
+    # Exception classes
+    "Error",
+    "ConfigFileError",
+    "AuthError",
+    "InvalidError",
+    "ConfigError",
+    "AgentNotHealthyError",
+    "AgentStartError",
+]

{pipecatcloud-0.0.9 → pipecatcloud-0.0.11}/src/pipecatcloud/__main__.py

@@ -1,3 +1,9 @@
+#
+# Copyright (c) 2025, Daily
+#
+# SPDX-License-Identifier: BSD 2-Clause License
+#
+
 from pipecatcloud.cli.entry_point import entrypoint_cli
 
 

{pipecatcloud-0.0.9 → pipecatcloud-0.0.11}/src/pipecatcloud/__version__.py

@@ -1,3 +1,9 @@
+#
+# Copyright (c) 2025, Daily
+#
+# SPDX-License-Identifier: BSD 2-Clause License
+#
+
 from pathlib import Path
 
 import toml

{pipecatcloud-0.0.9 → pipecatcloud-0.0.11}/src/pipecatcloud/_utils/async_utils.py

@@ -1,3 +1,9 @@
+#
+# Copyright (c) 2025, Daily
+#
+# SPDX-License-Identifier: BSD 2-Clause License
+#
+
 import inspect
 from typing import (
     TypeVar,

{pipecatcloud-0.0.9 → pipecatcloud-0.0.11}/src/pipecatcloud/_utils/auth_utils.py

@@ -1,3 +1,9 @@
+#
+# Copyright (c) 2025, Daily
+#
+# SPDX-License-Identifier: BSD 2-Clause License
+#
+
 import functools
 
 from pipecatcloud._utils.console_utils import console
@@ -16,4 +22,5 @@ def requires_login(func):
             )
             return
         return func(*args, **kwargs)
+
     return wrapper

pipecatcloud-0.0.11/src/pipecatcloud/_utils/console_utils.py

@@ -0,0 +1,141 @@
+#
+# Copyright (c) 2025, Daily
+#
+# SPDX-License-Identifier: BSD 2-Clause License
+#
+
+from typing import Optional, Union
+
+from rich.console import Console
+from rich.panel import Panel
+
+from pipecatcloud.cli import PANEL_TITLE_ERROR, PANEL_TITLE_SUCCESS, PIPECAT_CLI_NAME
+
+
+class PipecatConsole(Console):
+    def success(
+        self,
+        message,
+        title: Optional[str] = None,
+        title_extra: Optional[str] = None,
+        subtitle: Optional[str] = None,
+    ):
+        if not title:
+            title = f"{PANEL_TITLE_SUCCESS}{f' - {title_extra}' if title_extra is not None else ''}"
+
+        self.print(
+            Panel(
+                message,
+                title=f"[bold green]{title}[/bold green]",
+                subtitle=subtitle,
+                title_align="left",
+                subtitle_align="left",
+                border_style="green",
+            )
+        )
+
+    def error(
+        self,
+        message,
+        title: Optional[str] = None,
+        title_extra: Optional[str] = None,
+        subtitle: Optional[str] = None,
+    ):
+        if not title:
+            title = f"{PANEL_TITLE_ERROR}{f' - {title_extra}' if title_extra is not None else ''}"
+
+        self.print(
+            Panel(
+                message,
+                title=f"[bold red]{title}[/bold red]",
+                subtitle=subtitle,
+                title_align="left",
+                subtitle_align="left",
+                border_style="red",
+            )
+        )
+
+    def cancel(self):
+        self.print("[yellow]Cancelled by user[/yellow]")
+
+    def unauthorized(self):
+        self.print(
+            Panel(
+                f"Unauthorized request / invalid user token.\n\nPlease log in again using [bold cyan]{PIPECAT_CLI_NAME} auth login[/bold cyan]",
+                title=f"[bold red]{PANEL_TITLE_ERROR} - Unauthorized (401)[/bold red]",
+                subtitle="",
+                title_align="left",
+                subtitle_align="left",
+                border_style="red",
+            )
+        )
+
+    def api_error(
+        self,
+        error_code: Optional[Union[str, dict]] = None,
+        title: Optional[str] = "API Error",
+        hide_subtitle: bool = False,
+    ):
+        DEFAULT_ERROR_MESSAGE = "Unknown error. Please contact support."
+
+        if isinstance(error_code, dict):
+            error_message = error_code.get("error", DEFAULT_ERROR_MESSAGE)
+            code = error_code.get("code")
+        else:
+            error_message = str(error_code) if error_code else DEFAULT_ERROR_MESSAGE
+            code = None
+
+        if not error_message:
+            hide_subtitle = True
+
+        self.print(
+            Panel(
+                f"[red]{title}[/red]\n\n" f"[dim]Error message:[/dim]\n{error_message}",
+                title=f"[bold red]{PANEL_TITLE_ERROR}{f' - {code}' if code else ''}[/bold red]",
+                subtitle=f"[dim]Docs: https://docs.pipecat.daily.co/agents/error-codes#{code}[/dim]"
+                if not hide_subtitle and code
+                else None,
+                title_align="left",
+                subtitle_align="left",
+                border_style="red",
+            )
+        )
+
+
+console = PipecatConsole()
+
+
+def format_timestamp(timestamp: str) -> str:
+    """
+    Format a timestamp string to a more readable format.
+    Handles timestamps with variable microsecond precision.
+
+    Args:
+        timestamp (str): The timestamp string in ISO format with microseconds (e.g. "2024-01-01T12:34:56.789Z")
+
+    Returns:
+        str: The formatted timestamp string
+    """
+    from datetime import datetime
+
+    # First try parsing the timestamp directly
+    try:
+        return datetime.strptime(timestamp, "%Y-%m-%dT%H:%M:%S.%fZ").strftime("%Y-%m-%d %H:%M:%S")
+    except ValueError:
+        pass
+
+    # Handle case where microseconds have higher precision
+    try:
+        parts = timestamp.split(".")
+        if len(parts) == 2 and parts[1].endswith("Z"):
+            # Truncate microseconds to 6 digits
+            microseconds = parts[1][:-1][:6].ljust(6, "0")
+            normalized = f"{parts[0]}.{microseconds}Z"
+            return datetime.strptime(normalized, "%Y-%m-%dT%H:%M:%S.%fZ").strftime(
+                "%Y-%m-%d %H:%M:%S"
+            )
+    except (ValueError, IndexError):
+        pass
+
+    # Return original if parsing fails
+    return timestamp