agentsystems-sdk 0.3.5__py3-none-any.whl → 0.4.1__py3-none-any.whl

agentsystems_sdk/cli.py

@@ -24,6 +24,8 @@ from agentsystems_sdk.commands import (
     artifacts_path_command,
     clean_command,
     update_command,
+    version_command,
+    versions_command,
 )
 
 # Load .env before Typer parses env-var options
@@ -87,6 +89,8 @@ 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/commands/__init__.py

@@ -10,6 +10,7 @@ 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",
@@ -22,4 +23,6 @@ __all__ = [
     "artifacts_path_command",
     "clean_command",
     "update_command",
+    "version_command",
+    "versions_command",
 ]

agentsystems_sdk/commands/up.py

@@ -358,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.
 
@@ -378,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/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/deployments_scaffold/NOTICE

@@ -1,6 +1,6 @@
 This distribution orchestrates the following third-party components. Their source and full licence texts are available from the respective upstream projects.
 
-• Langfuse – © 2023-2025 Langfuse UG – MIT
+Copyright (c) 2023--2024 Langfuse GmbH
 • ClickHouse Server – © Altinity Inc – Apache-2.0
 • MinIO Server – © MinIO Inc – GNU AGPL v3
 • Redis – © Redis Ltd – BSD-3-Clause