agentsystems-sdk 0.3.5__py3-none-any.whl → 0.4.0__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-0.3.5.dist-info → agentsystems_sdk-0.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentsystems-sdk
-Version: 0.3.5
+Version: 0.4.0
 Summary: AgentSystems Python SDK and CLI
 Author-email: AgentSystems <support@agentsystems.ai>
 License-Expression: Apache-2.0

{agentsystems_sdk-0.3.5.dist-info → agentsystems_sdk-0.4.0.dist-info}/RECORD

@@ -1,9 +1,9 @@
 agentsystems_sdk/__init__.py,sha256=e0cW9_DFgYAM8oTyOXL_FyuqF_PELxPGLKTayhp4PqA,407
-agentsystems_sdk/cli.py,sha256=odiI4rbBEO5Xtug2vLRNxpStVh25wvjd0Nc-JqftctA,2373
+agentsystems_sdk/cli.py,sha256=6x_ZQ7nSKyGEzsQpUtLTkiVjhX7gqrgkkjmtofH7Qs4,2508
 agentsystems_sdk/config.py,sha256=-rlUtexDEg_PuEjM4x_kCMLnb5zvKkTNdKs1PbH-7ck,6659
 agentsystems_sdk/progress_tracker.py,sha256=34zW26QPlCGORkOYOK0cqbYIGvl5ga4Jp9cTN4Ar0RU,4082
 agentsystems_sdk/utils.py,sha256=sdza_FsmoZ8L4gS0HU3jQ6JjNfL030dhIkS8IOp5S6o,9230
-agentsystems_sdk/commands/__init__.py,sha256=j7madekbwkWkB12jkkrfCzPy6BNimVvIViIlPcfDaqU,599
+agentsystems_sdk/commands/__init__.py,sha256=spKxXRRsyD8huKx8U2E_NOd2AspB1cr6Fto_Plt89UI,701
 agentsystems_sdk/commands/artifacts.py,sha256=KTOEu0Cg9aeFEaNfOUW-lSJM7dewOC9KJYtyw8vESM4,1113
 agentsystems_sdk/commands/clean.py,sha256=-wyy7CleRmEew3SUlff0iYsCMLsj_JcwhlpqgQYhZZk,1942
 agentsystems_sdk/commands/down.py,sha256=z8VHzLfrxiVeedR9fl4CSjNPKuZ_0_R2vKI46rhEVRw,3318
@@ -12,8 +12,9 @@ agentsystems_sdk/commands/logs.py,sha256=2BpoXuQr_Vq_ou7oj1x-oYC552enWZiuKqoOEJO
 agentsystems_sdk/commands/restart.py,sha256=-UBZyHMfyQeG2pl-Mtff3cM6ziUvHrJVgqKl7sVWD0o,1923
 agentsystems_sdk/commands/run.py,sha256=3ptW48sq4APvY05AvCmBTdqcRfS3puERiFuInE2ddJ4,5440
 agentsystems_sdk/commands/status.py,sha256=C-9-eLG_gbDB4T69g4B3QjT41ASOZWjbEZydn2kcXM4,876
-agentsystems_sdk/commands/up.py,sha256=o7WnQMsqNPpjDmkOgSpD4sGyNgsGA2fj1M3_kpaWtlA,17117
+agentsystems_sdk/commands/up.py,sha256=HCWHlXjP_bPLUvOsrTtu8YRKUWysCKE9e3SRZG_yXaA,19913
 agentsystems_sdk/commands/update.py,sha256=mY3Yfk_X-P5CYE3wR1cZ4DzmrDknYXWl41ZwjDUvtNM,2968
+agentsystems_sdk/commands/version.py,sha256=sNmppGZucbc7UGY_YyiZy-wobeVxu7OMgH0vuz7Y7Ks,3179
 agentsystems_sdk/deployments_scaffold/.env.example,sha256=RBRZicUDHCnpozFMgT__IceUV69B7WNLUXHElkcXCD8,634
 agentsystems_sdk/deployments_scaffold/CONTRIBUTING.md,sha256=UgQ-CETCvOiMRszSxPBQURWJkAuAj-KwO42V7csQe1I,1145
 agentsystems_sdk/deployments_scaffold/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
@@ -29,10 +30,10 @@ agentsystems_sdk/deployments_scaffold/compose/local/db-backup/Dockerfile,sha256=
 agentsystems_sdk/deployments_scaffold/compose/local/db-backup/entrypoint.sh,sha256=7as7UNRCR5ziTOUWJGHtPgCb70oNLImWmGJsgTy0t-A,2462
 agentsystems_sdk/deployments_scaffold/compose/local/postgres-init/audit.sql,sha256=96812AZ2Tm57rmIi5de2nsAwxnn_AkJmavJgBn_MKKE,1796
 agentsystems_sdk/deployments_scaffold/schema/agentsystems-config.schema.json,sha256=fhZfE_fVSbv0vYvh9JT5EZC2XYjp9v54cP0UK6hH18A,1374
-agentsystems_sdk-0.3.5.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-agentsystems_sdk-0.3.5.dist-info/licenses/NOTICE,sha256=SGMFwyEoZ6NG19ZrdvwYt43lig12rEl5z8XvWMGej6c,918
-agentsystems_sdk-0.3.5.dist-info/METADATA,sha256=0Xh6gYeZoShwKRyh6Furz4eAvmsgfTCMA6Jse7UGxAY,11894
-agentsystems_sdk-0.3.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-agentsystems_sdk-0.3.5.dist-info/entry_points.txt,sha256=0lejF8v40DAB0D2612UWLLA3e1Ux8TyyLU6yJc0vQkQ,93
-agentsystems_sdk-0.3.5.dist-info/top_level.txt,sha256=nkHK6IHAO6-yoZJukUr0CruzkP8weBKraPnsj2FmDV8,17
-agentsystems_sdk-0.3.5.dist-info/RECORD,,
+agentsystems_sdk-0.4.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+agentsystems_sdk-0.4.0.dist-info/licenses/NOTICE,sha256=SGMFwyEoZ6NG19ZrdvwYt43lig12rEl5z8XvWMGej6c,918
+agentsystems_sdk-0.4.0.dist-info/METADATA,sha256=KXUI4wqQL5A5nG1YNt5pV9sS-ZVcEOBX-LFT9HJuwSg,11894
+agentsystems_sdk-0.4.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+agentsystems_sdk-0.4.0.dist-info/entry_points.txt,sha256=0lejF8v40DAB0D2612UWLLA3e1Ux8TyyLU6yJc0vQkQ,93
+agentsystems_sdk-0.4.0.dist-info/top_level.txt,sha256=nkHK6IHAO6-yoZJukUr0CruzkP8weBKraPnsj2FmDV8,17
+agentsystems_sdk-0.4.0.dist-info/RECORD,,