agentstack-cli 0.0.0__tar.gz → 0.4.0__tar.gz

agentstack_cli-0.4.0/PKG-INFO

@@ -0,0 +1,26 @@
+Metadata-Version: 2.3
+Name: agentstack-cli
+Version: 0.4.0
+Summary: Agent Stack CLI
+Author: IBM Corp.
+Requires-Dist: anyio~=4.10.0
+Requires-Dist: pydantic~=2.11.7
+Requires-Dist: pydantic-settings~=2.10.1
+Requires-Dist: requests~=2.32.5
+Requires-Dist: jsonschema~=4.25.1
+Requires-Dist: jsf~=0.11.2
+Requires-Dist: gnureadline~=8.2.13 ; sys_platform != 'win32'
+Requires-Dist: prompt-toolkit~=3.0.52
+Requires-Dist: inquirerpy~=0.3.4
+Requires-Dist: psutil~=7.0.0
+Requires-Dist: a2a-sdk
+Requires-Dist: tenacity~=9.1.2
+Requires-Dist: typer~=0.17.4
+Requires-Dist: pyyaml~=6.0.2
+Requires-Dist: agentstack-sdk
+Requires-Dist: authlib~=1.6.3
+Requires-Dist: openai~=1.107.1
+Requires-Python: >=3.13, <3.14
+Description-Content-Type: text/markdown
+
+# Agent Stack CLI

agentstack_cli-0.4.0/README.md

@@ -0,0 +1 @@
+# Agent Stack CLI

agentstack_cli-0.4.0/pyproject.toml

@@ -0,0 +1,81 @@
+[project]
+name = "agentstack-cli"
+version = "0.4.0"
+description = "Agent Stack CLI"
+readme = "README.md"
+authors = [{ name = "IBM Corp." }]
+requires-python = ">=3.13,<3.14"
+dependencies = [
+    "anyio~=4.10.0",
+    "pydantic~=2.11.7",
+    "pydantic-settings~=2.10.1",
+    "requests~=2.32.5",
+    "jsonschema~=4.25.1",
+    "jsf~=0.11.2",
+    'gnureadline~=8.2.13; sys_platform != "win32"',
+    "prompt-toolkit~=3.0.52",
+    "inquirerpy~=0.3.4",
+    "psutil~=7.0.0",
+    "a2a-sdk", # version determined by agentstack-sdk
+    "tenacity~=9.1.2",
+    "typer~=0.17.4",
+    "pyyaml~=6.0.2",
+    "agentstack-sdk",
+    "authlib~=1.6.3",
+    "openai~=1.107.1",
+]
+
+[dependency-groups]
+dev = [
+    "pyright>=1.1.399",
+    "pytest>=8.3.4",
+    "ruff>=0.8.5",
+    "wheel>=0.45.1",
+]
+
+[tool.uv.sources]
+agentstack-sdk = { path = "../agentstack-sdk-py", editable = true }
+
+[project.scripts]
+agentstack = "agentstack_cli:app"
+agentstack-cli = "agentstack_cli:app"
+
+[build-system]
+requires = ["uv_build>=0.9.0,<0.10.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+source-include = ["src/agentstack_cli/data"]
+source-exclude = ["**/.DS_Store"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py313"
+lint.select = [
+    "E", # pycodestyle errors
+    "W", # pycodestyle warnings
+    "F", # pyflakes
+    "UP", # pyupgrade
+    "I", # isort
+    "B", # bugbear
+    "N", # pep8-naming
+    "C4", # Comprehensions
+    "Q", # Quotes
+    "SIM", # Simplify
+    "RUF", # Ruff
+    "TID", # tidy-imports
+    "ASYNC", # async
+    # TODO: add "DTZ",   # DatetimeZ
+    # TODO: add "ANN",   # annotations
+]
+lint.ignore = [
+    "E501", # line lenght (annyoing)
+    "UP013", # update TypedDict to longer syntax -- not necessary
+]
+force-exclude = true
+
+[tool.pyright]
+reportUnusedCallResult = false
+ignore = ["tests/**", "examples/cli.py"]
+venvPath = "."
+venv = ".venv"

agentstack_cli-0.4.0/src/agentstack_cli/__init__.py

@@ -0,0 +1,77 @@
+# Copyright 2025 © BeeAI a Series of LF Projects, LLC
+# SPDX-License-Identifier: Apache-2.0
+
+import logging
+import typing
+from copy import deepcopy
+
+import typer
+
+import agentstack_cli.commands.agent
+import agentstack_cli.commands.build
+import agentstack_cli.commands.mcp
+import agentstack_cli.commands.model
+import agentstack_cli.commands.platform
+import agentstack_cli.commands.self
+import agentstack_cli.commands.server
+from agentstack_cli.async_typer import AsyncTyper
+from agentstack_cli.configuration import Configuration
+
+logging.basicConfig(level=logging.INFO if Configuration().debug else logging.FATAL)
+logging.getLogger("httpx").setLevel(logging.WARNING)  # not sure why this is necessary
+
+app = AsyncTyper(no_args_is_help=True)
+app.add_typer(agentstack_cli.commands.model.app, name="model", no_args_is_help=True, help="Manage model providers.")
+app.add_typer(agentstack_cli.commands.agent.app, name="agent", no_args_is_help=True, help="Manage agents.")
+app.add_typer(
+    agentstack_cli.commands.platform.app, name="platform", no_args_is_help=True, help="Manage Agent Stack platform."
+)
+app.add_typer(
+    agentstack_cli.commands.mcp.app, name="mcp", no_args_is_help=True, help="Manage MCP servers and toolkits."
+)
+app.add_typer(agentstack_cli.commands.build.app, name="", no_args_is_help=True, help="Build agent images.")
+app.add_typer(
+    agentstack_cli.commands.server.app,
+    name="server",
+    no_args_is_help=True,
+    help="Manage Agent Stack servers and authentication.",
+)
+app.add_typer(
+    agentstack_cli.commands.self.app,
+    name="self",
+    no_args_is_help=True,
+    help="Manage Agent Stack installation.",
+    hidden=True,
+)
+
+
+agent_alias = deepcopy(agentstack_cli.commands.agent.app)
+for cmd in agent_alias.registered_commands:
+    cmd.rich_help_panel = "Agent commands"
+
+app.add_typer(agent_alias, name="", no_args_is_help=True)
+
+
+@app.command("version")
+async def version(verbose: typing.Annotated[bool, typer.Option("-v", help="Show verbose output")] = False):
+    """Print version of the Agent Stack CLI."""
+    import agentstack_cli.commands.self
+
+    await agentstack_cli.commands.self.version(verbose=verbose)
+
+
+@app.command("ui")
+async def ui():
+    """Launch the graphical interface."""
+    import webbrowser
+
+    import agentstack_cli.commands.model
+
+    await agentstack_cli.commands.model.ensure_llm_provider()
+    webbrowser.open(
+        "http://localhost:8334"
+    )  # TODO: This always opens the local UI, how to open the UI of a logged in server instead?
+
+
+if __name__ == "__main__":
+    app()

agentstack_cli-0.4.0/src/agentstack_cli/api.py

@@ -0,0 +1,125 @@
+# Copyright 2025 © BeeAI a Series of LF Projects, LLC
+# SPDX-License-Identifier: Apache-2.0
+
+import re
+import urllib
+import urllib.parse
+from collections.abc import AsyncIterator
+from contextlib import asynccontextmanager
+from datetime import timedelta
+from typing import Any
+
+import httpx
+import openai
+from a2a.client import Client, ClientConfig, ClientFactory
+from a2a.types import AgentCard
+from httpx import HTTPStatusError
+from httpx._types import RequestFiles
+
+from agentstack_cli import configuration
+from agentstack_cli.configuration import Configuration
+
+config = Configuration()
+
+API_BASE_URL = "api/v1/"
+
+
+async def api_request(
+    method: str,
+    path: str,
+    json: dict | None = None,
+    files: RequestFiles | None = None,
+    params: dict[str, Any] | None = None,
+    use_auth: bool = True,
+) -> dict | None:
+    """Make an API request to the server."""
+    async with configuration.use_platform_client() as client:
+        response = await client.request(
+            method,
+            urllib.parse.urljoin(API_BASE_URL, path),
+            json=json,
+            files=files,
+            params=params,
+            timeout=60,
+            headers=(
+                {"Authorization": f"Bearer {token}"}
+                if use_auth and (token := config.auth_manager.load_auth_token())
+                else {}
+            ),
+        )
+        if response.is_error:
+            error = ""
+            try:
+                error = response.json()
+                error = error.get("detail", str(error))
+            except Exception:
+                response.raise_for_status()
+            if response.status_code == 401:
+                message = f'{error}\nexport AGENTSTACK__ADMIN_PASSWORD="<PASSWORD>" to set the admin password.'
+                raise HTTPStatusError(message=message, request=response.request, response=response)
+            raise HTTPStatusError(message=error, request=response.request, response=response)
+        if response.content:
+            return response.json()
+
+
+async def api_stream(
+    method: str,
+    path: str,
+    json: dict | None = None,
+    params: dict[str, Any] | None = None,
+    use_auth: bool = True,
+) -> AsyncIterator[dict[str, Any]]:
+    """Make a streaming API request to the server."""
+    import json as jsonlib
+
+    async with (
+        configuration.use_platform_client() as client,
+        client.stream(
+            method,
+            urllib.parse.urljoin(API_BASE_URL, path),
+            json=json,
+            params=params,
+            timeout=timedelta(hours=1).total_seconds(),
+            headers=(
+                {"Authorization": f"Bearer {token}"}
+                if use_auth and (token := config.auth_manager.load_auth_token())
+                else {}
+            ),
+        ) as response,
+    ):
+        response: httpx.Response
+        if response.is_error:
+            error = ""
+            try:
+                [error] = [jsonlib.loads(message) async for message in response.aiter_text()]
+                error = error.get("detail", str(error))
+            except Exception:
+                response.raise_for_status()
+            raise HTTPStatusError(message=error, request=response.request, response=response)
+        async for line in response.aiter_lines():
+            if line:
+                yield jsonlib.loads(re.sub("^data:", "", line).strip())
+
+
+@asynccontextmanager
+async def a2a_client(agent_card: AgentCard, use_auth: bool = True) -> AsyncIterator[Client]:
+    async with httpx.AsyncClient(
+        headers=(
+            {"Authorization": f"Bearer {token}"}
+            if use_auth and (token := config.auth_manager.load_auth_token())
+            else {}
+        ),
+        follow_redirects=True,
+        timeout=timedelta(hours=1).total_seconds(),
+    ) as httpx_client:
+        yield ClientFactory(ClientConfig(httpx_client=httpx_client, use_client_preference=True)).create(card=agent_card)
+
+
+@asynccontextmanager
+async def openai_client() -> AsyncIterator[openai.AsyncOpenAI]:
+    async with Configuration().use_platform_client() as platform_client:
+        yield openai.AsyncOpenAI(
+            api_key=platform_client.headers.get("Authorization", "").removeprefix("Bearer ") or "dummy",
+            base_url=urllib.parse.urljoin(str(platform_client.base_url), urllib.parse.urljoin(API_BASE_URL, "openai")),
+            default_headers=platform_client.headers,
+        )

agentstack_cli-0.4.0/src/agentstack_cli/async_typer.py

@@ -0,0 +1,104 @@
+# Copyright 2025 © BeeAI a Series of LF Projects, LLC
+# SPDX-License-Identifier: Apache-2.0
+
+import asyncio
+import functools
+import inspect
+import re
+import sys
+from collections.abc import Iterator
+from contextlib import contextmanager
+
+import rich.text
+import typer
+from rich.console import RenderResult
+from rich.markdown import Heading, Markdown
+from rich.table import Table
+from typer.core import TyperGroup
+
+from agentstack_cli.configuration import Configuration
+from agentstack_cli.console import console, err_console
+from agentstack_cli.utils import extract_messages, format_error
+
+DEBUG = Configuration().debug
+
+
+class _LeftAlignedHeading(Heading):
+    def __rich_console__(self, *args, **kwargs) -> RenderResult:
+        for elem in super().__rich_console__(*args, **kwargs):
+            if isinstance(elem, rich.text.Text):
+                elem.justify = "left"
+            yield elem
+
+
+Markdown.elements["heading_open"] = _LeftAlignedHeading
+
+
+@contextmanager
+def create_table(*args, no_wrap: bool = True, **kwargs) -> Iterator[Table]:
+    table = Table(*args, **kwargs, box=None, pad_edge=False, width=console.width, show_header=True)
+    yield table
+    for column in table.columns:
+        column.no_wrap = no_wrap
+        column.overflow = "ellipsis"
+        assert isinstance(column.header, str)
+        column.header = column.header.upper()
+
+    if not table.rows:
+        table._render = lambda *args, **kwargs: [rich.text.Text("<No items found>", style="italic")]
+
+
+class AliasGroup(TyperGroup):
+    """Taken from https://github.com/fastapi/typer/issues/132#issuecomment-2417492805"""
+
+    _CMD_SPLIT_P = re.compile(r" ?[,|] ?")
+
+    def get_command(self, ctx, cmd_name):
+        cmd_name = self._group_cmd_name(cmd_name)
+        return super().get_command(ctx, cmd_name)
+
+    def _group_cmd_name(self, default_name):
+        for cmd in self.commands.values():
+            name = cmd.name
+            if name and default_name in self._CMD_SPLIT_P.split(name):
+                return name
+        return default_name
+
+
+class AsyncTyper(typer.Typer):
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs, cls=AliasGroup)
+
+    def command(self, *args, **kwargs):
+        parent_decorator = super().command(*args, **kwargs)
+
+        def decorator(f):
+            @functools.wraps(f)
+            def wrapped_f(*args, **kwargs):
+                try:
+                    if inspect.iscoroutinefunction(f):
+                        return asyncio.run(f(*args, **kwargs))
+                    else:
+                        return f(*args, **kwargs)
+                except* Exception as ex:
+                    is_connect_error = False
+                    for exc_type, message in extract_messages(ex):
+                        err_console.print(format_error(exc_type, message))
+                        is_connect_error = is_connect_error or exc_type in ["ConnectionError", "ConnectError"]
+                        err_console.print()
+                    if is_connect_error:
+                        err_console.hint(
+                            "Start the Agent Stack platform using: [green]agentstack platform start[/green]. If that does not help, run [green]agentstack platform delete[/green] to clean up, then [green]agentstack platform start[/green] again."
+                        )
+                    else:
+                        err_console.hint(
+                            "Are you having consistent problems? If so, try these troubleshooting steps: [green]agentstack platform delete[/green] to remove the platform, and [green]agentstack platform start[/green] to recreate it."
+                        )
+                    if DEBUG:
+                        raise
+                    sys.exit(1)
+
+            parent_decorator(wrapped_f)
+            return f
+
+        return decorator

agentstack_cli-0.4.0/src/agentstack_cli/auth_manager.py

@@ -0,0 +1,115 @@
+# Copyright 2025 © BeeAI a Series of LF Projects, LLC
+# SPDX-License-Identifier: Apache-2.0
+
+import pathlib
+import typing
+from collections import defaultdict
+from typing import Any
+
+from pydantic import BaseModel, Field
+
+
+class AuthToken(BaseModel):
+    access_token: str
+    token_type: str = "Bearer"
+    expires_in: int | None = None
+    refresh_token: str | None = None
+    scope: str | None = None
+
+
+class AuthServer(BaseModel):
+    token: AuthToken | None = None
+
+
+class Server(BaseModel):
+    authorization_servers: dict[str, AuthServer] = Field(default_factory=dict)
+
+
+class Auth(BaseModel):
+    version: typing.Literal[1] = 1
+    servers: defaultdict[str, typing.Annotated[Server, Field(default_factory=Server)]] = Field(
+        default_factory=lambda: defaultdict(Server)
+    )
+    active_server: str | None = None
+    active_auth_server: str | None = None
+
+
+@typing.final
+class AuthManager:
+    def __init__(self, config_path: pathlib.Path):
+        self._auth_path = config_path
+        self._auth = self._load()
+
+    def _load(self) -> Auth:
+        if not self._auth_path.exists():
+            return Auth()
+        return Auth.model_validate_json(self._auth_path.read_bytes())
+
+    def _save(self) -> None:
+        self._auth_path.write_text(self._auth.model_dump_json(indent=2))
+
+    def save_auth_token(self, server: str, auth_server: str | None = None, token: dict[str, Any] | None = None) -> None:
+        if auth_server is not None and token is not None:
+            self._auth.servers[server].authorization_servers[auth_server] = AuthServer(token=AuthToken(**token))
+        else:
+            self._auth.servers[server]  # touch
+        self._save()
+
+    def load_auth_token(self) -> str | None:
+        active_res = self._auth.active_server
+        active_auth_server = self._auth.active_auth_server
+        if not active_res or not active_auth_server:
+            return None
+        server = self._auth.servers.get(active_res)
+        if not server:
+            return None
+
+        auth_server = server.authorization_servers.get(active_auth_server)
+        if not auth_server or not auth_server.token:
+            return None
+
+        return auth_server.token.access_token
+
+    def clear_auth_token(self, all: bool = False) -> None:
+        if all:
+            self._auth.servers = defaultdict(Server)
+        else:
+            if self._auth.active_server and self._auth.active_auth_server:
+                del self._auth.servers[self._auth.active_server].authorization_servers[self._auth.active_auth_server]
+            if self._auth.active_server and not self._auth.servers[self._auth.active_server].authorization_servers:
+                del self._auth.servers[self._auth.active_server]
+        self._auth.active_server = None
+        self._auth.active_auth_server = None
+        self._save()
+
+    def get_server(self, server: str) -> Server | None:
+        return self._auth.servers.get(server)
+
+    @property
+    def servers(self) -> list[str]:
+        return list(self._auth.servers.keys())
+
+    @property
+    def active_server(self) -> str | None:
+        return self._auth.active_server
+
+    @active_server.setter
+    def active_server(self, server: str | None) -> None:
+        if server is not None and server not in self._auth.servers:
+            raise ValueError(f"Server {server} not found")
+        self._auth.active_server = server
+        self._save()
+
+    @property
+    def active_auth_server(self) -> str | None:
+        return self._auth.active_auth_server
+
+    @active_auth_server.setter
+    def active_auth_server(self, auth_server: str | None) -> None:
+        if auth_server is not None and (
+            self._auth.active_server not in self._auth.servers
+            or auth_server not in self._auth.servers[self._auth.active_server].authorization_servers
+        ):
+            raise ValueError(f"Auth server {auth_server} not found in active server")
+        self._auth.active_auth_server = auth_server
+        self._save()

agentstack_cli-0.4.0/src/agentstack_cli/commands/__init__.py

@@ -0,0 +1,3 @@
+# Copyright 2025 © BeeAI a Series of LF Projects, LLC
+# SPDX-License-Identifier: Apache-2.0
+