glaip-sdk 0.0.3__py3-none-any.whl → 0.0.5__py3-none-any.whl

glaip_sdk/__init__.py

@@ -1,12 +1,12 @@
-"""AIP SDK - Python SDK for AI Agent Platform.
+"""GL AIP SDK - Python SDK for GDP Labs AI Agent Package.
 
 Authors:
     Raymond Christopher (raymond.christopher@gdplabs.id)
 """
 
-from ._version import __version__
-from .client import Client
-from .exceptions import AIPError
-from .models import MCP, Agent, Tool
+from glaip_sdk._version import __version__
+from glaip_sdk.client import Client
+from glaip_sdk.exceptions import AIPError
+from glaip_sdk.models import MCP, Agent, Tool
 
 __all__ = ["Client", "Agent", "Tool", "MCP", "AIPError", "__version__"]

glaip_sdk/branding.py

@@ -0,0 +1,146 @@
+"""AIP SDK Branding and Visual Identity.
+
+Simple, friendly CLI branding for the GL AIP (GDP Labs AI Agent Package) SDK.
+
+- Package name: GL AIP (GDP Labs AI Agent Package)
+- Version: auto-detected (AIP_VERSION env or importlib.metadata), or passed in
+- Colors: blue / bright_blue, with NO_COLOR/AIP_NO_COLOR fallbacks
+
+Author:
+    Raymond Christopher (raymond.christopher@gdplabs.id)
+"""
+
+from __future__ import annotations
+
+import os
+import platform
+import sys
+
+from rich.console import Console
+
+from glaip_sdk.rich_components import AIPPanel
+
+try:
+    # Python 3.8+ standard way to read installed package version
+    from importlib.metadata import PackageNotFoundError
+    from importlib.metadata import version as pkg_version
+except Exception:  # pragma: no cover
+    pkg_version = None
+    PackageNotFoundError = Exception
+
+
+# ---- minimal, readable styles (light blue + white theme) -----------------
+PRIMARY = "bright_blue"  # Light blue for main elements
+BORDER = "bright_blue"  # Light blue borders
+TITLE_STYLE = f"bold {PRIMARY}"
+LABEL = "bold"
+
+
+class AIPBranding:
+    """GL AIP SDK branding utilities with ASCII banner and version display."""
+
+    # GL AIP ASCII art - Modern block style with enhanced visibility
+    AIP_LOGO = r"""
+ ██████╗ ██╗         █████╗ ██╗██████╗
+██╔════╝ ██║        ██╔══██╗██║██╔══██╗
+██║  ███╗██║        ███████║██║██████╔╝
+██║   ██║██║        ██╔══██║██║██╔═══╝
+╚██████╔╝███████╗   ██║  ██║██║██║
+ ╚═════╝ ╚══════╝   ╚═╝  ╚═╝╚═╝╚═╝
+GDP Labs AI Agents Package
+""".strip("\n")
+
+    def __init__(
+        self,
+        version: str | None = None,
+        package_name: str | None = None,
+    ):
+        """
+        Args:
+            version: Explicit SDK version (overrides auto-detection).
+            package_name: If set, attempt to read version from installed package.
+        """
+        self.version = version or self._auto_version(package_name)
+        self.console = self._make_console()
+
+    # ---- small helpers --------------------------------------------------------
+    @staticmethod
+    def _auto_version(package_name: str | None) -> str:
+        # Priority: env → package metadata → fallback
+        env_version = os.getenv("AIP_VERSION")
+        if env_version:
+            return env_version
+        if package_name and pkg_version:
+            try:
+                return pkg_version(package_name)
+            except PackageNotFoundError:
+                pass
+        return "0.0.0"
+
+    @staticmethod
+    def _make_console() -> Console:
+        # Respect NO_COLOR/AIP_NO_COLOR environment variables
+        no_color_env = (
+            os.getenv("NO_COLOR") is not None or os.getenv("AIP_NO_COLOR") is not None
+        )
+        if no_color_env:
+            color_system = None
+            no_color = True
+        else:
+            color_system = "auto"
+            no_color = False
+        return Console(color_system=color_system, no_color=no_color, soft_wrap=True)
+
+    # ---- public API -----------------------------------------------------------
+    def get_welcome_banner(self) -> str:
+        """Get AIP banner with version info."""
+        banner = self.AIP_LOGO
+        line = f"Version: {self.version}"
+        banner = f"{banner}\n{line}"
+        return banner
+
+    def get_version_info(self) -> dict:
+        return {
+            "version": self.version,
+            "python_version": f"{sys.version_info.major}.{sys.version_info.minor}.{sys.version_info.micro}",
+            "platform": platform.platform(),
+            "architecture": platform.architecture()[0],
+        }
+
+    def display_welcome_panel(self, title: str = "Welcome to AIP") -> None:
+        banner = self.get_welcome_banner()
+        panel = AIPPanel(
+            banner,
+            title=f"[{TITLE_STYLE}]{title}[/{TITLE_STYLE}]",
+            border_style=BORDER,
+            padding=(1, 2),
+        )
+        self.console.print(panel)
+
+    def display_version_panel(self) -> None:
+        v = self.get_version_info()
+        version_text = (
+            f"[{TITLE_STYLE}]AIP SDK Version Information[/{TITLE_STYLE}]\n\n"
+            f"[{LABEL}]Version:[/] {v['version']}\n"
+            f"[{LABEL}]Python:[/] {v['python_version']}\n"
+            f"[{LABEL}]Platform:[/] {v['platform']}\n"
+            f"[{LABEL}]Architecture:[/] {v['architecture']}"
+        )
+        panel = AIPPanel(
+            version_text,
+            title=f"[{TITLE_STYLE}]Version Details[/{TITLE_STYLE}]",
+            border_style=BORDER,
+            padding=(1, 2),
+        )
+        self.console.print(panel)
+
+    def display_status_banner(self, status: str = "ready") -> None:
+        # Keep it simple (no emoji); easy to parse in logs/CI
+        banner = f"[{LABEL}]AIP[/{LABEL}] - {status.title()}"
+        self.console.print(banner)
+
+    @classmethod
+    def create_from_sdk(
+        cls, sdk_version: str | None = None, package_name: str | None = None
+    ) -> AIPBranding:
+        return cls(version=sdk_version, package_name=package_name)

glaip_sdk/cli/__init__.py

@@ -4,6 +4,6 @@ Authors:
     Raymond Christopher (raymond.christopher@gdplabs.id)
 """
 
-from .main import main
+from glaip_sdk.cli.main import main
 
 __all__ = ["main"]

glaip_sdk/cli/agent_config.py

@@ -0,0 +1,82 @@
+"""CLI-specific agent configuration utilities.
+
+This module provides CLI-only affordances for agent configuration,
+such as merging CLI flags over imported data.
+
+Authors:
+    Raymond Christopher (raymond.christopher@gdplabs.id)
+"""
+
+from typing import Any
+
+from glaip_sdk.utils.agent_config import (
+    resolve_language_model_selection,
+    sanitize_agent_config,
+)
+from glaip_sdk.utils.import_export import merge_import_with_cli_args
+
+
+def merge_agent_config_with_cli_args(
+    import_data: dict[str, Any], cli_args: dict[str, Any]
+) -> dict[str, Any]:
+    """Merge imported agent data with CLI arguments, preferring CLI args.
+
+    This is a CLI-specific wrapper that handles agent-specific merging logic.
+
+    Args:
+        import_data: Data loaded from import file
+        cli_args: Arguments passed via CLI
+
+    Returns:
+        Merged data dictionary
+
+    Notes:
+        - CLI arguments take precedence over imported data
+        - Handles agent-specific fields like tools and agents arrays
+        - Preserves agent configuration structure
+    """
+    return merge_import_with_cli_args(
+        import_data, cli_args, array_fields=["tools", "agents"]
+    )
+
+
+def resolve_agent_language_model_selection(
+    merged_data: dict[str, Any], cli_model: str | None
+) -> tuple[dict[str, Any], bool]:
+    """Resolve language model selection for agent creation/update.
+
+    This is a CLI-specific wrapper around the core LM selection logic.
+
+    Args:
+        merged_data: Merged import data and CLI args
+        cli_model: Model specified via CLI --model flag
+
+    Returns:
+        Tuple of (lm_selection_dict, should_strip_lm_identity)
+    """
+    return resolve_language_model_selection(merged_data, cli_model)
+
+
+def sanitize_agent_config_for_cli(
+    agent_config: dict | None,
+    *,
+    strip_credentials: bool = True,
+    strip_lm_identity: bool = False,
+) -> dict:
+    """Sanitize agent_config for CLI operations.
+
+    This is a CLI-specific wrapper around the core sanitization logic.
+
+    Args:
+        agent_config: The agent configuration to sanitize
+        strip_credentials: Always drop lm_credentials (default: True)
+        strip_lm_identity: Also drop lm_provider/lm_name/lm_base_url when True
+
+    Returns:
+        Sanitized agent configuration
+    """
+    return sanitize_agent_config(
+        agent_config,
+        strip_credentials=strip_credentials,
+        strip_lm_identity=strip_lm_identity,
+    )

glaip_sdk/cli/commands/__init__.py

@@ -1,5 +1,5 @@
-"""CLI commands package."""
+"""CLI commands package exports."""
 
-from . import agents, init, mcps, models, tools
+from glaip_sdk.cli.commands import agents, configure, mcps, models, tools
 
-__all__ = ["agents", "tools", "mcps", "models", "init"]
+__all__ = ["agents", "tools", "mcps", "models", "configure"]