agentsystems-sdk 0.3.4__py3-none-any.whl → 0.4.0__py3-none-any.whl

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/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/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/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/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/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.dist-info → agentsystems_sdk-0.4.0.dist-info}/METADATA

@@ -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.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=rfHvkBI3Y6QSz8vFmxAyLT0hk1DnXBpXsKhqJ2sFpeg,2310
+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=8971J2BzjeEGfmewU_iX8TUg2_3Umd4MmfrM_QdfHgQ,9156
-agentsystems_sdk/commands/__init__.py,sha256=b_lONb7CywM_wCBBYYrTCFi8kvxFc8M6j5IWc2Mg0kg,542
+agentsystems_sdk/utils.py,sha256=sdza_FsmoZ8L4gS0HU3jQ6JjNfL030dhIkS8IOp5S6o,9230
+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,7 +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=dy0a58DubwznbongbjYRMXUUZdVHvIzkmjW68fXMwPY,16702
+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
@@ -28,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.4.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-agentsystems_sdk-0.3.4.dist-info/licenses/NOTICE,sha256=SGMFwyEoZ6NG19ZrdvwYt43lig12rEl5z8XvWMGej6c,918
-agentsystems_sdk-0.3.4.dist-info/METADATA,sha256=Krz6sw23zsrCysUiGS4VW9BeI123jkLnzV8gOCnCPUU,11687
-agentsystems_sdk-0.3.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-agentsystems_sdk-0.3.4.dist-info/entry_points.txt,sha256=0lejF8v40DAB0D2612UWLLA3e1Ux8TyyLU6yJc0vQkQ,93
-agentsystems_sdk-0.3.4.dist-info/top_level.txt,sha256=nkHK6IHAO6-yoZJukUr0CruzkP8weBKraPnsj2FmDV8,17
-agentsystems_sdk-0.3.4.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,,