agentsystems-sdk 0.3.4__tar.gz → 0.4.0__tar.gz

{agentsystems_sdk-0.3.4/agentsystems_sdk.egg-info → agentsystems_sdk-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentsystems-sdk
-Version: 0.3.4
+Version: 0.4.0
 Summary: AgentSystems Python SDK and CLI
 Author-email: AgentSystems <support@agentsystems.ai>
 License-Expression: Apache-2.0
@@ -91,6 +91,7 @@ All commands are available through `agentsystems` (or the shorter alias `agntsys
 | `agentsystems version` | Show the installed SDK version. |
 | `agentsystems artifacts-path THREAD_ID [REL_PATH]` | Resolve a path inside the shared artifacts volume using thread-centric structure. |
 | `agentsystems run AGENT PAYLOAD` | Invoke an agent with JSON payload and optional file uploads, stream progress, and return results. |
+| `agentsystems update [PROJECT_DIR]` | Update core platform images (agent-control-plane, agentsystems-ui) to latest versions. Faster than re-running `up` when you only need to update platform components. |
 
 ### `up` options
 

{agentsystems_sdk-0.3.4 → agentsystems_sdk-0.4.0}/README.md

@@ -73,6 +73,7 @@ All commands are available through `agentsystems` (or the shorter alias `agntsys
 | `agentsystems version` | Show the installed SDK version. |
 | `agentsystems artifacts-path THREAD_ID [REL_PATH]` | Resolve a path inside the shared artifacts volume using thread-centric structure. |
 | `agentsystems run AGENT PAYLOAD` | Invoke an agent with JSON payload and optional file uploads, stream progress, and return results. |
+| `agentsystems update [PROJECT_DIR]` | Update core platform images (agent-control-plane, agentsystems-ui) to latest versions. Faster than re-running `up` when you only need to update platform components. |
 
 ### `up` options
 

{agentsystems_sdk-0.3.4 → agentsystems_sdk-0.4.0}/agentsystems_sdk/cli.py

@@ -23,6 +23,9 @@ from agentsystems_sdk.commands import (
     run_command,
     artifacts_path_command,
     clean_command,
+    update_command,
+    version_command,
+    versions_command,
 )
 
 # Load .env before Typer parses env-var options
@@ -85,6 +88,9 @@ app.command(name="status")(status_command)
 app.command(name="run")(run_command)
 app.command(name="artifacts-path")(artifacts_path_command)
 app.command(name="clean")(clean_command)
+app.command(name="update")(update_command)
+app.command(name="version")(version_command)
+app.command(name="versions")(versions_command)
 
 
 if __name__ == "__main__":

{agentsystems_sdk-0.3.4 → agentsystems_sdk-0.4.0}/agentsystems_sdk/commands/__init__.py

@@ -9,6 +9,8 @@ from .status import status_command
 from .run import run_command
 from .artifacts import artifacts_path_command
 from .clean import clean_command
+from .update import update_command
+from .version import version_command, versions_command
 
 __all__ = [
     "init_command",
@@ -20,4 +22,7 @@ __all__ = [
     "run_command",
     "artifacts_path_command",
     "clean_command",
+    "update_command",
+    "version_command",
+    "versions_command",
 ]

{agentsystems_sdk-0.3.4 → agentsystems_sdk-0.4.0}/agentsystems_sdk/commands/up.py

@@ -116,6 +116,18 @@ def setup_agents_from_config(
         if not reg or not reg.enabled:
             continue  # skip disabled registries
 
+        # Check if all images for this registry are already present
+        env_base = os.environ.copy()
+        missing_images = [
+            a.image for a in agents_list if not _image_exists(a.image, env_base)
+        ]
+
+        if not missing_images:
+            console.print(
+                f"[green]✓ All images from {reg.url} already present, skipping login.[/green]"
+            )
+            continue
+
         # Create a fresh Docker config dir so credentials don't clobber
         with tempfile.TemporaryDirectory(
             prefix="agentsystems-docker-config-"
@@ -346,6 +358,18 @@ def up_command(
         dir_okay=False,
         resolve_path=True,
     ),
+    agent_control_plane_version: Optional[str] = typer.Option(
+        None,
+        "--agent-control-plane",
+        "--acp",
+        help="Pin agent-control-plane to specific version (e.g., 0.3.17)",
+    ),
+    agentsystems_ui_version: Optional[str] = typer.Option(
+        None,
+        "--agentsystems-ui",
+        "--ui",
+        help="Pin agentsystems-ui to specific version (e.g., 0.1.5)",
+    ),
 ) -> None:
     """Start the full AgentSystems platform via docker compose.
 
@@ -366,6 +390,64 @@ def up_command(
     env_base = os.environ.copy()
     env_base["DOCKER_CONFIG"] = isolated_cfg.name
 
+    # Validate and set version tags from CLI flags if provided
+    def _validate_version(version_str: str, min_version: str, component: str) -> bool:
+        """Validate that version meets minimum requirements for version management features."""
+        import re
+
+        # Skip validation for special tags
+        if version_str in ["latest", "main", "development"]:
+            return True
+
+        # Validate semantic version format
+        if not re.match(r"^\d+\.\d+\.\d+$", version_str):
+            console.print(
+                f"[red]❌ Error: {component} version must be semantic version (x.y.z format)[/red]"
+            )
+            console.print(f"[red]   You provided: {version_str}[/red]")
+            console.print("[red]   Valid examples: 0.4.0, 1.2.3[/red]")
+            return False
+
+        # Simple version comparison (works for our use case)
+        def version_tuple(v):
+            return tuple(map(int, v.split(".")))
+
+        try:
+            if version_tuple(version_str) < version_tuple(min_version):
+                console.print(
+                    f"[red]❌ Error: {component} version {version_str} does not support version management[/red]"
+                )
+                console.print(
+                    f"[red]   Minimum required {component}: {min_version}[/red]"
+                )
+                console.print(
+                    "[red]   This version introduced /version and /component-versions endpoints[/red]"
+                )
+                return False
+        except Exception:
+            console.print(f"[red]❌ Error: Invalid version format: {version_str}[/red]")
+            return False
+
+        return True
+
+    if agent_control_plane_version:
+        if not _validate_version(
+            agent_control_plane_version, "0.4.0", "agent-control-plane"
+        ):
+            raise typer.Exit(1)
+        env_base["ACP_TAG"] = agent_control_plane_version
+        console.print(
+            f"[yellow]📌 Pinning agent-control-plane to version: {agent_control_plane_version}[/yellow]"
+        )
+
+    if agentsystems_ui_version:
+        if not _validate_version(agentsystems_ui_version, "0.2.0", "agentsystems-ui"):
+            raise typer.Exit(1)
+        env_base["UI_TAG"] = agentsystems_ui_version
+        console.print(
+            f"[yellow]📌 Pinning agentsystems-ui to version: {agentsystems_ui_version}[/yellow]"
+        )
+
     # .env gets loaded later – keep env_base in sync
     def _sync_env_base() -> None:
         env_base.update(os.environ)

agentsystems_sdk-0.4.0/agentsystems_sdk/commands/update.py

@@ -0,0 +1,88 @@
+"""Update core platform images."""
+
+from __future__ import annotations
+
+import pathlib
+from typing import Optional
+
+import typer
+from rich.console import Console
+from rich.progress import Progress, SpinnerColumn, TextColumn
+
+from ..utils import ensure_docker_installed, run_command
+
+console = Console()
+
+
+def update_command(
+    project_dir: Optional[pathlib.Path] = typer.Argument(
+        None,
+        exists=True,
+        file_okay=False,
+        dir_okay=True,
+        readable=True,
+        resolve_path=True,
+        help="Project directory (defaults to current directory)",
+    ),
+) -> None:
+    """Update core AgentSystems platform images to latest versions.
+
+    Pulls the latest versions of:
+    - agent-control-plane (gateway)
+    - agentsystems-ui (web interface)
+
+    This is faster than re-running 'agentsystems up' when you only need
+    to update the core platform components.
+    """
+    if project_dir is None:
+        project_dir = pathlib.Path.cwd()
+
+    project_dir = project_dir.expanduser().resolve()
+
+    # Verify this is an AgentSystems project
+    config_file = project_dir / "agentsystems-config.yml"
+    if not config_file.exists():
+        console.print(f"[red]✗ No agentsystems-config.yml found in {project_dir}[/red]")
+        console.print("This doesn't appear to be an AgentSystems project directory.")
+        raise typer.Exit(code=1)
+
+    ensure_docker_installed()
+
+    # Core platform images to update
+    core_images = [
+        "ghcr.io/agentsystems/agent-control-plane:latest",
+        "ghcr.io/agentsystems/agentsystems-ui:latest",
+    ]
+
+    console.print("\n[bold cyan]Updating AgentSystems core platform images[/bold cyan]")
+
+    with Progress(
+        SpinnerColumn(style="cyan"),
+        TextColumn("[bold]{task.description}"),
+        console=console,
+    ) as progress:
+
+        for image in core_images:
+            task = progress.add_task(f"Updating {image.split('/')[-1]}", total=None)
+
+            try:
+                progress.stop()  # Stop to show docker output
+                run_command(["docker", "pull", image])
+                progress.start()  # Restart progress
+                progress.update(task, description=f"✓ Updated {image.split('/')[-1]}")
+            except typer.Exit:
+                progress.start()  # Ensure progress is restarted
+                progress.update(
+                    task, description=f"✗ Failed to update {image.split('/')[-1]}"
+                )
+                console.print(f"[red]Failed to pull {image}[/red]")
+                raise
+            finally:
+                progress.start()  # Always ensure progress is running
+
+    console.print("\n[green]✅ Core platform images updated successfully![/green]")
+    console.print("\n[bold]Next steps:[/bold]")
+    console.print("  • Run [cyan]agentsystems restart[/cyan] to use the updated images")
+    console.print(
+        "  • Or [cyan]agentsystems down && agentsystems up[/cyan] for a full restart"
+    )

agentsystems_sdk-0.4.0/agentsystems_sdk/commands/version.py

@@ -0,0 +1,86 @@
+"""Version information command for AgentSystems SDK."""
+
+from __future__ import annotations
+
+import importlib.metadata
+from rich.console import Console
+from rich.table import Table
+
+console = Console()
+
+
+def version_command() -> None:
+    """Display SDK version information only.
+
+    For all component versions, use 'agentsystems versions'.
+    """
+    # Just show SDK version
+    try:
+        sdk_version = importlib.metadata.version("agentsystems-sdk")
+    except importlib.metadata.PackageNotFoundError:
+        sdk_version = "unknown (development mode)"
+    console.print(f"AgentSystems SDK: {sdk_version}")
+
+
+def versions_command() -> None:
+    """Display version information for all AgentSystems components.
+
+    Queries the running deployment to show current versions and update status.
+    Only works when a deployment is running.
+    """
+    table = Table(title="AgentSystems Component Versions")
+    table.add_column("Component", style="cyan")
+    table.add_column("Version", style="green")
+    table.add_column("Status", style="yellow")
+
+    # SDK version
+    try:
+        sdk_version = importlib.metadata.version("agentsystems-sdk")
+        table.add_row("AgentSystems SDK", sdk_version, "✓ Installed")
+    except importlib.metadata.PackageNotFoundError:
+        table.add_row("AgentSystems SDK", "unknown", "⚠ Development mode")
+
+    # Try to query running deployment for gateway and UI versions
+    try:
+        import requests
+
+        resp = requests.get("http://localhost:18080/component-versions", timeout=5)
+        if resp.status_code == 200:
+            data = resp.json()
+            components = data.get("components", {})
+
+            # Agent Control Plane
+            acp = components.get("agent-control-plane", {})
+            acp_version = acp.get("current_version", "unknown")
+            acp_update = acp.get("update_available", False)
+            acp_status = "✓ Running" + (
+                " (update available)" if acp_update else " (latest)"
+            )
+            table.add_row("Agent Control Plane", acp_version, acp_status)
+
+            # AgentSystems UI
+            ui = components.get("agentsystems-ui", {})
+            ui_version = ui.get("current_version", "unknown")
+            ui_update = ui.get("update_available", False)
+            ui_status = "✓ Running" + (
+                " (update available)" if ui_update else " (latest)"
+            )
+            table.add_row("AgentSystems UI", ui_version, ui_status)
+
+        else:
+            table.add_row(
+                "Agent Control Plane", "unknown", "⚠ Deployment not accessible"
+            )
+            table.add_row("AgentSystems UI", "unknown", "⚠ Deployment not accessible")
+
+    except Exception:
+        # Deployment not running or not accessible
+        table.add_row("Agent Control Plane", "N/A", "⚠ Deployment not running")
+        table.add_row("AgentSystems UI", "N/A", "⚠ Deployment not running")
+
+    console.print(table)
+    # Note: Simple check since Rich table internals are complex
+    if "⚠" in str(table):
+        console.print(
+            "\n[dim]Note: Start deployment with 'agentsystems up' to check running versions[/dim]"
+        )

{agentsystems_sdk-0.3.4 → agentsystems_sdk-0.4.0}/agentsystems_sdk/utils.py

@@ -263,9 +263,9 @@ def get_required_images() -> List[str]:
     Returns:
         List of Docker image names
     """
-    return [
-        "ghcr.io/agentsystems/agent-control-plane:latest",
-    ]
+    # Control plane and other images are pulled during 'agentsystems up'
+    # when the docker-compose file is processed, not during init
+    return []
 
 
 def cleanup_langfuse_init_vars(env_path: pathlib.Path) -> None:

{agentsystems_sdk-0.3.4 → agentsystems_sdk-0.4.0/agentsystems_sdk.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentsystems-sdk
-Version: 0.3.4
+Version: 0.4.0
 Summary: AgentSystems Python SDK and CLI
 Author-email: AgentSystems <support@agentsystems.ai>
 License-Expression: Apache-2.0
@@ -91,6 +91,7 @@ All commands are available through `agentsystems` (or the shorter alias `agntsys
 | `agentsystems version` | Show the installed SDK version. |
 | `agentsystems artifacts-path THREAD_ID [REL_PATH]` | Resolve a path inside the shared artifacts volume using thread-centric structure. |
 | `agentsystems run AGENT PAYLOAD` | Invoke an agent with JSON payload and optional file uploads, stream progress, and return results. |
+| `agentsystems update [PROJECT_DIR]` | Update core platform images (agent-control-plane, agentsystems-ui) to latest versions. Faster than re-running `up` when you only need to update platform components. |
 
 ### `up` options
 

{agentsystems_sdk-0.3.4 → agentsystems_sdk-0.4.0}/agentsystems_sdk.egg-info/SOURCES.txt

@@ -24,6 +24,8 @@ agentsystems_sdk/commands/restart.py
 agentsystems_sdk/commands/run.py
 agentsystems_sdk/commands/status.py
 agentsystems_sdk/commands/up.py
+agentsystems_sdk/commands/update.py
+agentsystems_sdk/commands/version.py
 agentsystems_sdk/deployments_scaffold/.env.example
 agentsystems_sdk/deployments_scaffold/CONTRIBUTING.md
 agentsystems_sdk/deployments_scaffold/LICENSE

{agentsystems_sdk-0.3.4 → agentsystems_sdk-0.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentsystems-sdk"
-version = "0.3.4"
+version = "0.4.0"
 description = "AgentSystems Python SDK and CLI"
 readme = "README.md"
 authors = [ { name = "AgentSystems", email = "support@agentsystems.ai" } ]

{agentsystems_sdk-0.3.4 → agentsystems_sdk-0.4.0}/tests/test_cli_up.py

@@ -88,6 +88,8 @@ agents:
             agents_mode=AgentStartMode.all,
             no_langfuse=False,
             env_file=None,
+            agent_control_plane_version=None,
+            agentsystems_ui_version=None,
         )
 
         # Verify
@@ -161,6 +163,8 @@ agents:
             agents_mode=AgentStartMode.none,
             no_langfuse=False,
             env_file=None,
+            agent_control_plane_version=None,
+            agentsystems_ui_version=None,
         )
 
         # Should call setup_agents with none mode
@@ -196,6 +200,8 @@ agents:
                 no_langfuse=False,
                 agents_mode=AgentStartMode.create,
                 env_file=None,
+                agent_control_plane_version=None,
+                agentsystems_ui_version=None,
             )
 
     @patch("agentsystems_sdk.commands.up.subprocess.run")
@@ -265,6 +271,8 @@ agents:
             agents_mode=AgentStartMode.none,  # Should skip agent setup
             no_langfuse=False,
             env_file=None,
+            agent_control_plane_version=None,
+            agentsystems_ui_version=None,
         )
 
         # Should call setup_agents with none mode which will skip actual agent setup
@@ -339,6 +347,8 @@ agents:
             agents_mode=AgentStartMode.all,
             no_langfuse=True,  # Should pass langfuse=False to compose_args
             env_file=None,
+            agent_control_plane_version=None,
+            agentsystems_ui_version=None,
         )
 
         # Verify compose_args was called with langfuse=False
@@ -392,6 +402,8 @@ agents:
                 no_langfuse=False,
                 agents_mode=AgentStartMode.create,
                 env_file=None,
+                agent_control_plane_version=None,
+                agentsystems_ui_version=None,
             )
 
     @patch("agentsystems_sdk.commands.up.subprocess.run")
@@ -460,9 +472,13 @@ agents:
         up_command(
             project_dir=tmp_path,
             detach=True,
+            fresh=False,
             wait_ready=True,
             agents_mode=AgentStartMode.all,
+            no_langfuse=False,
             env_file=custom_env,  # Use custom env file
+            agent_control_plane_version=None,
+            agentsystems_ui_version=None,
         )
 
         # Should succeed even without default .env

{agentsystems_sdk-0.3.4 → agentsystems_sdk-0.4.0}/tests/test_utils.py

@@ -320,7 +320,8 @@ EQUALS_IN_VALUE=key=value
         images = get_required_images()
 
         assert isinstance(images, list)
-        assert "ghcr.io/agentsystems/agent-control-plane:latest" in images
+        # Images are now pulled during 'agentsystems up', not 'agentsystems init'
+        assert len(images) == 0
 
     def test_cleanup_langfuse_init_vars_first_time(self, tmp_path):
         """Test cleanup_langfuse_init_vars on first cleanup."""