pipecatcloud 0.1.5__tar.gz → 0.1.6__tar.gz

{pipecatcloud-0.1.5 → pipecatcloud-0.1.6}/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.6] - 2025-04-25
+
+# Changed
+
+- `min-instances` and `max-instances` has been changed to reflect API terminology changes.
+
 ## [0.1.5] - 2025-04-09
 
 # Added

{pipecatcloud-0.1.5/src/pipecatcloud.egg-info → pipecatcloud-0.1.6}/PKG-INFO

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

{pipecatcloud-0.1.5 → pipecatcloud-0.1.6}/pyproject.toml

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

{pipecatcloud-0.1.5 → pipecatcloud-0.1.6}/src/pipecatcloud/_utils/deploy_utils.py

@@ -5,10 +5,11 @@
 #
 
 import os
-from typing import Optional
+import functools
+from typing import Optional, Callable, Any
 
 import toml
-from attr import dataclass
+from attr import dataclass, field
 from loguru import logger
 
 from pipecatcloud.exception import ConfigFileError
@@ -22,23 +23,37 @@ DEPLOY_STATUS_MAP = {
 
 @dataclass
 class ScalingParams:
-    min_instances: Optional[int] = 0
-    max_instances: Optional[int] = 10
+    min_agents: Optional[int] = 0
+    max_agents: Optional[int] = None
+    # @deprecated
+    min_instances: Optional[int] = field(default=None, metadata={"deprecated": True})
+    # @deprecated
+    max_instances: Optional[int] = field(default=None, metadata={"deprecated": True})
 
     def __attrs_post_init__(self):
+        # Handle deprecated fields
         if self.min_instances is not None:
-            if self.min_instances < 0:
-                raise ValueError("min_instances must be greater than or equal to 0")
+            logger.warning("min_instances is deprecated, use min_agents instead")
+            self.min_agents = self.min_instances
 
         if self.max_instances is not None:
-            if self.max_instances < 1:
-                raise ValueError("max_instances must be greater than 0")
+            logger.warning("max_instances is deprecated, use max_agents instead")
+            self.max_agents = self.max_instances
 
-            if self.min_instances is not None and self.max_instances < self.min_instances:
-                raise ValueError("max_instances must be greater than or equal to min_instances")
+        # Validation
+        if self.min_agents is not None:
+            if self.min_agents < 0:
+                raise ValueError("min_agents must be greater than or equal to 0")
+
+        if self.max_agents is not None:
+            if self.max_agents < 1:
+                raise ValueError("max_agents must be greater than 0")
+
+            if self.min_agents is not None and self.max_agents < self.min_agents:
+                raise ValueError("max_agents must be greater than or equal to min_agents")
 
     def to_dict(self):
-        return {"min_instances": self.min_instances, "max_instances": self.max_instances}
+        return {"min_agents": self.min_agents, "max_agents": self.max_agents}
 
 
 @dataclass
@@ -95,7 +110,8 @@ def load_deploy_config_file() -> Optional[DeployConfigParams]:
             "image_credentials",
             "secret_set",
             "scaling",
-            "enable_krisp"}
+            "enable_krisp",
+        }
         unexpected_keys = set(config_data.keys()) - expected_keys
         if unexpected_keys:
             raise ConfigFileError(f"Unexpected keys in config file: {unexpected_keys}")
@@ -105,3 +121,20 @@ def load_deploy_config_file() -> Optional[DeployConfigParams]:
     except Exception as e:
         logger.debug(e)
         raise ConfigFileError(str(e))
+
+
+def with_deploy_config(func: Callable) -> Callable:
+    """
+    Decorator that loads the deploy config file and injects it into the function.
+    If the config file exists, it will be loaded and passed to the function as `deploy_config`.
+    """
+    @functools.wraps(func)
+    def wrapper(*args, **kwargs):
+        try:
+            deploy_config = load_deploy_config_file()
+            kwargs['deploy_config'] = deploy_config
+        except Exception as e:
+            logger.error(f"Error loading deploy config: {e}")
+            raise ConfigFileError(str(e))
+        return func(*args, **kwargs)
+    return wrapper

{pipecatcloud-0.1.5 → pipecatcloud-0.1.6}/src/pipecatcloud/api.py

@@ -317,8 +317,8 @@ class _API:
             "imagePullSecretSet": deploy_config.image_credentials,
             "secretSet": deploy_config.secret_set,
             "autoScaling": {
-                "minReplicas": deploy_config.scaling.min_instances,
-                "maxReplicas": deploy_config.scaling.max_instances,
+                "minAgents": deploy_config.scaling.min_agents,
+                "maxAgents": deploy_config.scaling.max_agents,
             },
             "enableKrisp": deploy_config.enable_krisp,
         }

{pipecatcloud-0.1.5 → pipecatcloud-0.1.6}/src/pipecatcloud/cli/commands/agent.py

@@ -25,7 +25,7 @@ from pipecatcloud._utils.console_utils import console, format_timestamp
 from pipecatcloud.cli import PIPECAT_CLI_NAME
 from pipecatcloud.cli.api import API
 from pipecatcloud.cli.config import config
-from pipecatcloud._utils.deploy_utils import load_deploy_config_file, DeployConfigParams
+from pipecatcloud._utils.deploy_utils import with_deploy_config, DeployConfigParams
 
 agent_cli = typer.Typer(name="agent", help="Agent management", no_args_is_help=True)
 
@@ -137,11 +137,11 @@ async def status(
         if autoscaling_data:
             scaling_renderables = [
                 Panel(
-                    f"[bold]Minimum Instances[/bold]\n{autoscaling_data.get('minReplicas', 0)}",
+                    f"[bold]Minimum Agents[/bold]\n{autoscaling_data.get('minAgents', 0)}",
                     expand=True,
                 ),
                 Panel(
-                    f"[bold]Maximum Instances[/bold]\n{autoscaling_data.get('maxReplicas', 0)}",
+                    f"[bold]Maximum Agents[/bold]\n{autoscaling_data.get('maxAgents', 0)}",
                     expand=True,
                 ),
             ]
@@ -443,7 +443,9 @@ async def deployments(
 @agent_cli.command(name="start", help="Start an agent instance")
 @synchronizer.create_blocking
 @requires_login
+@with_deploy_config
 async def start(
+    deploy_config=typer.Option(None, hidden=True),
     agent_name: str = typer.Argument(None, help="Name of the agent to start e.g. 'my-agent'"),
     force: bool = typer.Option(
         False,
@@ -495,20 +497,14 @@ async def start(
     )
 
     # Load values from deployment config file (if one exists)
-    partial_config = DeployConfigParams()
-    try:
-        if deploy_config := load_deploy_config_file():
-            partial_config = deploy_config
-    except Exception as e:
-        console.error(str(e))
-        return typer.Exit()
+    partial_config = deploy_config or DeployConfigParams()
 
     # Get agent name from pcc-deploy.toml if not provided
     if not agent_name:
         default_agent_name = partial_config.agent_name
 
         if not default_agent_name:
-            console.error("No agent name provided and no default agent name found in pcc-deploy.toml")
+            console.error("No target agent name provided")
             return typer.Exit(1)
 
         agent_name = default_agent_name

{pipecatcloud-0.1.5 → pipecatcloud-0.1.6}/src/pipecatcloud/cli/commands/deploy.py

@@ -20,7 +20,7 @@ from pipecatcloud._utils.console_utils import console
 from pipecatcloud._utils.deploy_utils import (
     DeployConfigParams,
     ScalingParams,
-    load_deploy_config_file,
+    with_deploy_config,
 )
 from pipecatcloud.cli import PIPECAT_CLI_NAME
 from pipecatcloud.cli.api import API
@@ -223,26 +223,28 @@ def create_deploy_command(app: typer.Typer):
     @app.command(name="deploy", help="Deploy agent to Pipecat Cloud")
     @synchronizer.create_blocking
     @requires_login
+    @with_deploy_config
     async def deploy(
+        deploy_config=typer.Option(None, hidden=True),
         agent_name: str = typer.Argument(
             None, help="Name of the agent to deploy e.g. 'my-agent'", show_default=False
         ),
         image: str = typer.Argument(
             None, help="Docker image location e.g. 'my-image:latest'", show_default=False
         ),
-        min_instances: int = typer.Option(
+        min_agents: int = typer.Option(
             None,
-            "--min-instances",
+            "--min-agents",
             "-min",
-            help="Minimum number of instances to keep warm",
+            help="Minimum number of agents to keep warm",
             rich_help_panel="Deployment Configuration",
             min=0,
         ),
-        max_instances: int = typer.Option(
+        max_agents: int = typer.Option(
             None,
-            "--max-instances",
+            "--max-agents",
             "-max",
-            help="Maximum number of allowed instances",
+            help="Maximum number of allowed agents",
             rich_help_panel="Deployment Configuration",
             min=1,
             max=50,
@@ -281,7 +283,34 @@ def create_deploy_command(app: typer.Typer):
             "-f",
             help="Force deployment / skip confirmation",
         ),
+        # @deprecated
+        min_instances: int = typer.Option(
+            None,
+            "--min-instances",
+            help="[Deprecated] Use --min-agents instead",
+            hidden=True,
+            min=0,
+        ),
+        # @deprecated
+        max_instances: int = typer.Option(
+            None,
+            "--max-instances",
+            help="[Deprecated] Use --max-agents instead",
+            hidden=True,
+            min=1,
+            max=50,
+        ),
     ):
+
+        # Handle @deprecated options
+        if min_instances is not None:
+            logger.warning("min_instances is deprecated, use min_agents instead")
+            min_agents = min_instances
+
+        if max_instances is not None:
+            logger.warning("max_instances is deprecated, use max_agents instead")
+            max_agents = max_instances
+
         org = organization or config.get("org")
 
         # Compose deployment config from CLI options and config file (if provided)
@@ -290,15 +319,7 @@ def create_deploy_command(app: typer.Typer):
         #   2. Values from the config toml file
         #   3. CLI command defaults
 
-        partial_config = DeployConfigParams()
-
-        # Load values from deployment config file (if one exists)
-        try:
-            if deploy_config := load_deploy_config_file():
-                partial_config = deploy_config
-        except Exception as e:
-            console.error(str(e))
-            return typer.Exit()
+        partial_config = deploy_config or DeployConfigParams()
 
         # Override any local config values from passed CLI arguments
         partial_config.agent_name = agent_name or partial_config.agent_name
@@ -306,12 +327,12 @@ def create_deploy_command(app: typer.Typer):
         partial_config.image_credentials = credentials or partial_config.image_credentials
         partial_config.secret_set = secret_set or partial_config.secret_set
         partial_config.scaling = ScalingParams(
-            min_instances=min_instances
-            if min_instances is not None
-            else partial_config.scaling.min_instances,
-            max_instances=max_instances
-            if max_instances is not None
-            else partial_config.scaling.max_instances,
+            min_agents=min_agents
+            if min_agents is not None
+            else partial_config.scaling.min_agents,
+            max_agents=max_agents
+            if max_agents is not None
+            else partial_config.scaling.max_agents,
         )
         partial_config.enable_krisp = krisp or partial_config.enable_krisp
 
@@ -328,8 +349,11 @@ def create_deploy_command(app: typer.Typer):
         table = Table(show_header=False, border_style="dim", show_edge=True, show_lines=True)
         table.add_column("Property", style="cyan")
         table.add_column("Value", style="green")
-        table.add_row("Min instances", str(partial_config.scaling.min_instances))
-        table.add_row("Max instances", str(partial_config.scaling.max_instances))
+        table.add_row("Min agents", str(partial_config.scaling.min_agents))
+        if partial_config.scaling.max_agents:
+            table.add_row("Max agents", str(partial_config.scaling.max_agents))
+        else:
+            table.add_row("Max agents", "[dim]Use existing or default[/dim]")
 
         content = Group(
             (f"[bold white]Agent name:[/bold white] [green]{partial_config.agent_name}[/green]"),
@@ -344,11 +368,11 @@ def create_deploy_command(app: typer.Typer):
             (
                 [
                     Text(
-                        f"Note: Usage costs will apply for {partial_config.scaling.min_instances} reserved instance(s). Please see: https://www.daily.co/pricing/pipecat-cloud/",
+                        f"Note: Usage costs will apply for {partial_config.scaling.min_agents} reserved agent(s). Please see: https://www.daily.co/pricing/pipecat-cloud/",
                         style="red",
-                    )] if partial_config.scaling.min_instances else [
+                    )] if partial_config.scaling.min_agents else [
                     Text(
-                        "Note: Deploying with 0 minimum instances may result in cold starts",
+                        "Note: Deploying with 0 minimum agents may result in cold starts",
                         style="red",
                     )]),
         )

{pipecatcloud-0.1.5 → pipecatcloud-0.1.6/src/pipecatcloud.egg-info}/PKG-INFO

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