pipecatcloud 1.0.0__tar.gz → 1.1.0__tar.gz

{pipecatcloud-1.0.0 → pipecatcloud-1.1.0}/CHANGELOG.md

@@ -5,6 +5,91 @@ 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).
 
+## [1.1.0] - 2026-08-05
+
+### Added
+
+- New global `--output {rich,plain,json}` option for every `pipecat cloud`
+  command, also settable via the `PIPECAT_OUTPUT` environment variable or the
+  `output` config key. Note the option is placed before the subcommand
+  (`pipecat cloud --output json agent list`); in CI, setting `PIPECAT_OUTPUT`
+  once avoids ordering concerns. `rich` is the interactive default; `plain` is
+  line-oriented with no boxes and no truncation; `json` emits one
+  machine-readable JSON object on stdout with all human output on stderr.
+  When stdout is not a terminal the CLI now defaults to `plain`.
+
+- Progress is now visible when output is piped or redirected. Long-running
+  operations (deploy rollout polling, cloud builds) print each status
+  transition as a timestamped line instead of rendering nothing outside a
+  terminal. Cloud-build polling additionally reports build status changes.
+
+- Listings (`agent list`, `agent sessions`, `agent deployments`,
+  `secrets list`, `organizations list`, `organizations keys list`, `build
+  list`, `regions list`, and friends) render as tab-separated rows with
+  full, untruncated values in `plain` mode. Piped output previously fell
+  back to an 80-column table that silently ellipsized IDs.
+
+- `agent status` and `agent deployments` now show `Build: <build id>` for
+  cloud-built deployments instead of `Image: N/A`. Cloud builds produce an
+  image managed by Pipecat Cloud, so the build ID is the reference to use
+  when checking which artifact a deployment is running.
+
+### Changed
+
+- **The CLI now exits non-zero on failure.** Previously every error path
+  exited `0` — including failed deploys and running commands while logged
+  out — so CI pipelines could not detect failures. Errors and user
+  cancellations exit `1`; usage errors and refused non-interactive prompts
+  exit `2`. Pipelines that depended on the old always-zero behavior will
+  now correctly fail.
+
+- Commands that would show a confirmation prompt now fail fast with exit
+  code `2` when stdin is not a terminal, pointing at the bypass flag
+  (`--yes`/`--force`/`--skip`), instead of hanging or misbehaving in CI.
+
+- `organizations list` and `organizations keys create` label their
+  organization columns **Organization Name** (the display name) and
+  **Organization ID** (the identifier `--organization` takes), matching
+  the dashboard. The values are unchanged, as is `--output json`, which
+  emits the server's own field names. Scripts scraping the previous
+  `Organization` / `Name` headers out of table output need updating. In
+  `organizations list`, the active-organization marker moved to its own
+  `Active` column, so the ID column holds nothing but the identifier.
+
+- CLI messages call an organization an "organization" rather than a
+  "namespace". The Kubernetes namespace an organization maps to is an
+  implementation detail, so messages about missing agents, secret sets,
+  or accounts now name the organization. `organizations select` reports
+  an unmatched `--organization` value as an unknown organization ID and
+  points at `organizations list`.
+
+### Deprecated
+
+- `spend-limit show --json` still works but is now an alias for the global
+  `--output json` mode.
+
+### Fixed
+
+- `organizations keys create` no longer reports a new key as "Using as
+  default in local config" when it was not stored as the default. The
+  panel carries that note only when the key actually became the default.
+
+## [1.0.1] - 2026-07-13
+
+### Fixed
+
+- `pipecat cloud deploy` now verifies the image pull secret passed via
+  `--credentials` by looking it up in the secrets list, matching on both name
+  and type. Previously the check misread an API error response as "secret
+  exists", and a regular secret set with the same name also passed. A deploy
+  referencing a missing image pull secret now aborts with a clear error
+  instead of proceeding.
+
+- Documentation links in CLI output now point to `docs.pipecat.ai` instead of
+  the retired `docs.pipecat.daily.co` domain. API error panels link directly
+  to the matching entry in the error codes reference, and the deploy and
+  image pull secret prompts link to the image pull secrets guide.
+
 ## [1.0.0] - 2026-06-19
 
 ### Added

{pipecatcloud-1.0.0 → pipecatcloud-1.1.0}/CLAUDE.md

@@ -8,7 +8,7 @@ Guidance for Claude Code working in this repo.
 
 - Package root: `src/pipecatcloud/`
 - CLI: registered as a Pipecat CLI extension via the `pipecat_cli.extensions:cloud` entry point (surfaced as `pipecat cloud`). There is no standalone entry point — no `[project.scripts]` and no `__main__`; the CLI runs only through the Pipecat CLI.
-- Public docs: https://docs.pipecat.daily.co
+- Public docs: https://docs.pipecat.ai/pipecat-cloud
 
 ## Toolchain
 

{pipecatcloud-1.0.0 → pipecatcloud-1.1.0}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: pipecatcloud
-Version: 1.0.0
+Version: 1.1.0
 Summary: Cloud hosting for Pipecat AI applications
 License: BSD 2-Clause License
-Project-URL: Website, https://docs.pipecat.daily.co/
+Project-URL: Website, https://docs.pipecat.ai/pipecat-cloud
 Keywords: pipecat,pipecat-ai,voice,ai,llm
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -25,7 +25,7 @@ Dynamic: license-file
  <img alt="pipecat cloud" width="500px" height="auto" src="https://raw.githubusercontent.com/daily-co/pipecat-cloud/main/pipecat-cloud.png">
 </div></h1>
 
-[![Docs](https://img.shields.io/badge/documentation-blue)](https://docs.pipecat.daily.co)
+[![Docs](https://img.shields.io/badge/documentation-blue)](https://docs.pipecat.ai/pipecat-cloud)
 [![PyPI](https://img.shields.io/pypi/v/pipecatcloud)](https://pypi.org/project/pipecatcloud)
 
 # Pipecat Cloud
@@ -41,7 +41,7 @@ Python module and CLI for interacting with [Pipecat Cloud](https://pipecat.daily
 
 ### Documentation
 
-Documentation for Pipecat Cloud is available [here](https://docs.pipecat.daily.co).
+Documentation for Pipecat Cloud is available [here](https://docs.pipecat.ai/pipecat-cloud).
 
 ### Installation
 

{pipecatcloud-1.0.0 → pipecatcloud-1.1.0}/README.md

@@ -2,7 +2,7 @@
  <img alt="pipecat cloud" width="500px" height="auto" src="https://raw.githubusercontent.com/daily-co/pipecat-cloud/main/pipecat-cloud.png">
 </div></h1>
 
-[![Docs](https://img.shields.io/badge/documentation-blue)](https://docs.pipecat.daily.co)
+[![Docs](https://img.shields.io/badge/documentation-blue)](https://docs.pipecat.ai/pipecat-cloud)
 [![PyPI](https://img.shields.io/pypi/v/pipecatcloud)](https://pypi.org/project/pipecatcloud)
 
 # Pipecat Cloud
@@ -18,7 +18,7 @@ Python module and CLI for interacting with [Pipecat Cloud](https://pipecat.daily
 
 ### Documentation
 
-Documentation for Pipecat Cloud is available [here](https://docs.pipecat.daily.co).
+Documentation for Pipecat Cloud is available [here](https://docs.pipecat.ai/pipecat-cloud).
 
 ### Installation
 

{pipecatcloud-1.0.0 → pipecatcloud-1.1.0}/pyproject.toml

@@ -41,7 +41,7 @@ dev = [
     "pytest>=9.0.0,<10",
     "pytest-asyncio>=1.0.0,<2",
     "ruff>=0.12.11,<1",
-    "setuptools~=78.1.1",
+    "setuptools>=83.0.0,<84",
     "setuptools_scm~=8.3.1",
     # Needed to import/test pipecatcloud.agent (the optional pipecat surface).
     "pipecat-ai>=1.0.0",
@@ -77,7 +77,7 @@ select = [
 "**/__init__.py" = ["D104"]
 
 [project.urls]
-Website = "https://docs.pipecat.daily.co/"
+Website = "https://docs.pipecat.ai/pipecat-cloud"
 
 [tool.setuptools_scm]
 local_scheme = "no-local-version"

{pipecatcloud-1.0.0 → pipecatcloud-1.1.0}/src/pipecatcloud/_utils/auth_utils.py

@@ -7,6 +7,7 @@
 import functools
 
 import aiohttp
+import typer
 
 from pipecatcloud.__version__ import version
 from pipecatcloud._utils.console_utils import console
@@ -46,7 +47,7 @@ def requires_login(func):
             console.error(
                 f"You are not logged in. Please run `{PIPECAT_CLI_NAME} auth login` first.",
             )
-            return
+            raise typer.Exit(1)
 
         # When org is not set locally (e.g. PIPECAT_TOKEN without a config file),
         # resolve the user's default organization from the API.
@@ -59,7 +60,7 @@ def requires_login(func):
                     "Could not determine your organization. "
                     f"Set PIPECAT_ORG or run `{PIPECAT_CLI_NAME} auth login`.",
                 )
-                return
+                raise typer.Exit(1)
 
         return await func(*args, **kwargs)
 

{pipecatcloud-1.0.0 → pipecatcloud-1.1.0}/src/pipecatcloud/_utils/console_utils.py

@@ -4,8 +4,11 @@
 # SPDX-License-Identifier: BSD 2-Clause License
 #
 
+import json
 import statistics
+import sys
 from datetime import datetime
+from enum import Enum
 
 from rich.console import Console
 from rich.panel import Panel
@@ -13,6 +16,65 @@ from rich.panel import Panel
 from pipecatcloud.cli import PANEL_TITLE_ERROR, PANEL_TITLE_SUCCESS, PIPECAT_CLI_NAME
 
 
+class OutputMode(str, Enum):
+    """How the CLI renders its output.
+
+    - ``rich``: panels, spinners, and tables (the interactive default)
+    - ``plain``: line-oriented output — no boxes, no spinners, no truncation
+    - ``json``: one machine-parseable JSON object on stdout; all human
+      output is redirected to stderr
+    """
+
+    rich = "rich"
+    plain = "plain"
+    json = "json"
+
+
+def stdin_is_interactive() -> bool:
+    """Whether we can prompt the user. Separate function so tests can patch it."""
+    try:
+        return sys.stdin.isatty()
+    except (AttributeError, ValueError):
+        return False
+
+
+class _PlainStatus:
+    """Drop-in replacement for rich's Status in non-interactive output.
+
+    Rich renders nothing from ``console.status(...)`` when stdout is not a
+    terminal, which left long-running operations (e.g. the up-to-600s deploy
+    poll loop) completely silent in CI. This sink prints each *distinct*
+    status message as a timestamped line instead, so piped output shows
+    every transition without spamming identical poll updates.
+    """
+
+    def __init__(self, console: "PipecatConsole", message: str | None = None):
+        self._console = console
+        self._last: str | None = None
+        self._stopped = False
+        if message:
+            self.update(message)
+
+    def update(self, status: str | None = None, **kwargs) -> None:
+        if not status or self._stopped or status == self._last:
+            return
+        self._last = status
+        timestamp = datetime.now().strftime("%H:%M:%S")
+        self._console.print(rf"[dim]\[{timestamp}][/dim] {status}")
+
+    def start(self) -> None:
+        self._stopped = False
+
+    def stop(self) -> None:
+        self._stopped = True
+
+    def __enter__(self) -> "_PlainStatus":
+        return self
+
+    def __exit__(self, *_exc) -> None:
+        self.stop()
+
+
 def format_cents(cents: int | None) -> str:
     """Render a cents value as a USD dollar string (e.g. 1234 -> "$12.34").
 
@@ -28,6 +90,92 @@ def format_cents(cents: int | None) -> str:
 
 
 class PipecatConsole(Console):
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        # None means "auto": rich on a terminal, plain otherwise.
+        self._explicit_output_mode: OutputMode | None = None
+
+    @property
+    def output_mode(self) -> OutputMode:
+        if self._explicit_output_mode is not None:
+            return self._explicit_output_mode
+        return OutputMode.rich if self.is_terminal else OutputMode.plain
+
+    def set_output_mode(self, mode: OutputMode) -> None:
+        self._explicit_output_mode = mode
+        if mode == OutputMode.json:
+            # stdout is reserved for the single JSON payload; every human-facing
+            # write on this console moves to stderr so parsers see pure JSON.
+            self.file = sys.stderr
+
+    @property
+    def rich_output(self) -> bool:
+        return self.output_mode == OutputMode.rich
+
+    @property
+    def json_output(self) -> bool:
+        return self.output_mode == OutputMode.json
+
+    def output_json(self, data) -> None:
+        """Write the single machine-readable JSON object to stdout.
+
+        In json mode this console's own writes go to stderr, so this is the
+        only thing that touches stdout — parsers get pure JSON.
+        """
+        sys.stdout.write(json.dumps(data, indent=2, default=str) + "\n")
+        sys.stdout.flush()
+
+    def status(self, status, **kwargs):  # pyright: ignore[reportIncompatibleMethodOverride]
+        # Returns rich's Status in rich mode and a line-printing _PlainStatus
+        # otherwise; both expose update()/stop()/context-manager.
+        if self.rich_output:
+            return super().status(status, **kwargs)
+        return _PlainStatus(self, str(status))
+
+    def require_interactive(self, flag_hint: str | None = "--yes") -> None:
+        """Fail fast instead of letting a prompt hang or misbehave in CI.
+
+        Exits 2 (usage error) when a prompt would be shown but stdin is not a
+        terminal, pointing at the flag that skips the prompt when one exists.
+        """
+        import typer
+
+        if not stdin_is_interactive():
+            remedy = (
+                f"Pass [bold]{flag_hint}[/bold] to run non-interactively."
+                if flag_hint
+                else "This command requires an interactive terminal."
+            )
+            self.error(f"Confirmation required but input is not a terminal.\n{remedy}")
+            raise typer.Exit(2)
+
+    def print(self, *objects, **kwargs):
+        # In non-rich modes, never hard-wrap plain text lines: wrapped IDs and
+        # URIs are as unparseable as truncated ones.
+        if not self.rich_output and objects and all(isinstance(o, str) for o in objects):
+            kwargs.setdefault("soft_wrap", True)
+        return super().print(*objects, **kwargs)
+
+    def print_records(
+        self,
+        columns: list[str],
+        rows: list[tuple],
+        title: str | None = None,
+    ) -> None:
+        """Plain-mode listing: tab-separated, full values, no boxes.
+
+        Rich tables ellipsize cell values at 80 columns when piped, which
+        silently corrupts IDs consumed by scripts. Rows are written straight to
+        the output stream — bypassing Rich's tab expansion and line wrapping —
+        so the output stays greppable and `cut`-able.
+        """
+        if title:
+            self.print(title)
+        self.file.write("\t".join(columns) + "\n")
+        for row in rows:
+            self.file.write("\t".join("" if cell is None else str(cell) for cell in row) + "\n")
+        self.file.flush()
+
     def success(
         self,
         message,
@@ -38,6 +186,16 @@ class PipecatConsole(Console):
         if not title:
             title = f"{PANEL_TITLE_SUCCESS}{f' - {title_extra}' if title_extra is not None else ''}"
 
+        if not self.rich_output:
+            if isinstance(message, str):
+                self.print(f"[bold green]{title}:[/bold green] {message}")
+            else:
+                self.print(f"[bold green]{title}[/bold green]")
+                self.print(message)
+            if subtitle:
+                self.print(subtitle)
+            return
+
         self.print(
             Panel(
                 message,
@@ -59,6 +217,16 @@ class PipecatConsole(Console):
         if not title:
             title = f"{PANEL_TITLE_ERROR}{f' - {title_extra}' if title_extra is not None else ''}"
 
+        if not self.rich_output:
+            if isinstance(message, str):
+                self.print(f"[bold red]{title}:[/bold red] {message}")
+            else:
+                self.print(f"[bold red]{title}[/bold red]")
+                self.print(message)
+            if subtitle:
+                self.print(subtitle)
+            return
+
         self.print(
             Panel(
                 message,
@@ -74,9 +242,16 @@ class PipecatConsole(Console):
         self.print("[yellow]Cancelled by user[/yellow]")
 
     def unauthorized(self):
+        message = (
+            "Unauthorized request / invalid user token.\n\n"
+            f"Please log in again using [bold cyan]{PIPECAT_CLI_NAME} auth login[/bold cyan]"
+        )
+        if not self.rich_output:
+            self.error(message, title=f"{PANEL_TITLE_ERROR} - Unauthorized (401)")
+            return
         self.print(
             Panel(
-                f"Unauthorized request / invalid user token.\n\nPlease log in again using [bold cyan]{PIPECAT_CLI_NAME} auth login[/bold cyan]",
+                message,
                 title=f"[bold red]{PANEL_TITLE_ERROR} - Unauthorized (401)[/bold red]",
                 subtitle="",
                 title_align="left",
@@ -112,13 +287,22 @@ class PipecatConsole(Console):
         if not error_message:
             hide_subtitle = True
 
+        panel_title = f"{PANEL_TITLE_ERROR}{f' - {code}' if code else ''}"
+        subtitle = (
+            f"[dim]Docs: https://docs.pipecat.ai/pipecat-cloud/fundamentals/error-codes#{str(code).lower()}[/dim]"
+            if not hide_subtitle and code
+            else None
+        )
+
+        if not self.rich_output:
+            self.error(f"{title}: {error_message}", title=panel_title, subtitle=subtitle)
+            return
+
         self.print(
             Panel(
                 f"[red]{title}[/red]\n\n[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=f"[bold red]{panel_title}[/bold red]",
+                subtitle=subtitle,
                 title_align="left",
                 subtitle_align="left",
                 border_style="red",
@@ -158,6 +342,10 @@ class PipecatConsole(Console):
             f"Or visit [link={dashboard}]{dashboard}[/link]"
         )
 
+        if not self.rich_output:
+            self.error(body, title=f"{PANEL_TITLE_ERROR} - Spend limit reached (402)")
+            return
+
         self.print(
             Panel(
                 body,

{pipecatcloud-1.0.0 → pipecatcloud-1.1.0}/src/pipecatcloud/api.py

@@ -197,6 +197,10 @@ class _API:
 
         if not self.error:
             return
+        # In json mode the machine-readable error goes to stdout; the human
+        # rendering below lands on stderr (the console is redirected there).
+        if self.is_cli and getattr(console, "json_output", False):
+            console.output_json({"error": self.error})
         if isinstance(self.error, dict) and self.error.get("code", "400") == "401":
             console.unauthorized()
         else: