glaip-sdk 0.6.20__py3-none-any.whl → 0.6.21__py3-none-any.whl

glaip_sdk/cli/commands/update.py

@@ -6,9 +6,12 @@ Author:
 
 from __future__ import annotations
 
+import importlib.util
+import os
 import subprocess
 import sys
 from collections.abc import Sequence
+from pathlib import Path
 
 import click
 from rich.console import Console
@@ -21,11 +24,54 @@ PACKAGE_NAME = "glaip-sdk"
 def _is_uv_managed_environment() -> bool:
     """Check if running in a uv-managed tool environment.
 
-    Uses a path-based heuristic that may need updates if uv changes its layout.
+    Uses a path-based heuristic against sys.executable, sys.prefix, and UV_TOOL_DIR
+    or UV_TOOL_BIN to detect a case-insensitive "uv/tools" segment. Update if uv
+    changes its layout.
     """
-    executable = str(sys.executable)
-    # Check for uv tool install paths: ~/.local/share/uv/tools/*/bin/python*
-    return ".local/share/uv/tools" in executable or "/uv/tools/" in executable
+    if _has_uv_tool_path(sys.executable):
+        return True
+    if _has_uv_tool_path(sys.prefix):
+        return True
+    uv_tool_dir = os.environ.get("UV_TOOL_DIR") or os.environ.get("UV_TOOL_BIN")
+    if uv_tool_dir and _has_uv_tool_path(uv_tool_dir):
+        return True
+    return False
+
+
+def _has_uv_tool_path(path: str) -> bool:
+    """Return True when a path contains a case-insensitive uv/tools segment."""
+    parts = [part.lower() for part in Path(path).parts]
+    for idx, part in enumerate(parts[:-1]):
+        if part == "uv" and parts[idx + 1] == "tools":
+            return True
+    return False
+
+
+def _is_pip_available() -> bool:
+    """Return True when pip can be imported in the current interpreter."""
+    return importlib.util.find_spec("pip") is not None
+
+
+def _build_missing_pip_guidance(
+    *,
+    include_prerelease: bool,
+    package_name: str = PACKAGE_NAME,
+    force_reinstall: bool = False,
+) -> tuple[str, str]:
+    """Return error and troubleshooting guidance when pip is unavailable."""
+    manual_cmd = _build_manual_upgrade_command(
+        include_prerelease,
+        package_name=package_name,
+        is_uv=True,
+        force_reinstall=force_reinstall,
+    )
+    error_detail = "pip is not available in this environment."
+    troubleshooting = (
+        "💡 Troubleshooting:\n"
+        f"   • If you installed via uv tool, run: {manual_cmd}\n"
+        "   • Otherwise install pip: python -m ensurepip"
+    )
+    return error_detail, troubleshooting
 
 
 def _build_command_parts(
@@ -115,6 +161,11 @@ def update_command(include_prerelease: bool) -> None:
     console = Console()
     # Call _is_uv_managed_environment() once and pass explicitly to avoid redundant calls
     is_uv = _is_uv_managed_environment()
+    if not is_uv and not _is_pip_available():
+        error_detail, troubleshooting = _build_missing_pip_guidance(
+            include_prerelease=include_prerelease,
+        )
+        raise click.ClickException(f"{error_detail}\n{troubleshooting}")
     upgrade_cmd = _build_upgrade_command(include_prerelease, is_uv=is_uv)
 
     # Determine the appropriate manual command for error messages

glaip_sdk/cli/main.py

@@ -36,8 +36,10 @@ from glaip_sdk.cli.commands.models import models_group
 from glaip_sdk.cli.commands.tools import tools_group
 from glaip_sdk.cli.commands.transcripts import transcripts_group
 from glaip_sdk.cli.commands.update import (
+    _build_missing_pip_guidance,
     _build_manual_upgrade_command,
     _build_upgrade_command,
+    _is_pip_available,
     _is_uv_managed_environment,
     update_command,
 )
@@ -52,6 +54,9 @@ from glaip_sdk.config.constants import (
 from glaip_sdk.icons import ICON_AGENT
 from glaip_sdk.rich_components import AIPPanel, AIPTable
 
+# Constants
+UPDATE_ERROR_TITLE = "❌ Update Error"
+
 Client: type[Any] | None = None
 
 
@@ -557,6 +562,21 @@ def update(check_only: bool, force: bool) -> None:
         # Update using pip or uv tool install
         try:
             is_uv = _is_uv_managed_environment()
+            if not is_uv and not _is_pip_available():
+                error_detail, troubleshooting = _build_missing_pip_guidance(
+                    include_prerelease=False,
+                    package_name="glaip-sdk",
+                    force_reinstall=force,
+                )
+                console.print(
+                    AIPPanel(
+                        f"[{ERROR_STYLE}]❌ Update failed[/]\n\n🔍 Error: {error_detail}\n\n{troubleshooting}",
+                        title=UPDATE_ERROR_TITLE,
+                        border_style=ERROR,
+                        padding=(0, 1),
+                    ),
+                )
+                sys.exit(1)
             cmd = list(
                 _build_upgrade_command(
                     include_prerelease=False,
@@ -609,7 +629,7 @@ def update(check_only: bool, force: bool) -> None:
             console.print(
                 AIPPanel(
                     f"[{ERROR_STYLE}]❌ Update failed[/]\n\n🔍 Error: {error_detail}\n\n{troubleshooting}",
-                    title="❌ Update Error",
+                    title=UPDATE_ERROR_TITLE,
                     border_style=ERROR,
                     padding=(0, 1),
                 ),
@@ -627,7 +647,7 @@ def update(check_only: bool, force: bool) -> None:
             console.print(
                 AIPPanel(
                     f"[{ERROR_STYLE}]❌ Update failed[/]\n\n🔍 Error: {e.stderr}\n\n{troubleshooting}",
-                    title="❌ Update Error",
+                    title=UPDATE_ERROR_TITLE,
                     border_style=ERROR,
                     padding=(0, 1),
                 ),

glaip_sdk/cli/update_notifier.py

@@ -27,6 +27,8 @@ from glaip_sdk.branding import (
     WARNING_STYLE,
 )
 from glaip_sdk.cli.commands.update import (
+    PACKAGE_NAME,
+    _build_command_parts,
     _build_manual_upgrade_command,
     _is_uv_managed_environment,
     update_command,
@@ -219,27 +221,90 @@ def _prompt_update_decision(console: Console) -> Literal["update", "skip"]:
         console.print(f"[{ERROR_STYLE}]Please enter 1 to update now or 2 to skip.[/]")
 
 
+def _get_manual_upgrade_command(is_uv: bool) -> str:
+    """Get the manual upgrade command for the given environment type.
+
+    Args:
+        is_uv: True if running in uv tool environment, False for pip environment.
+
+    Returns:
+        Manual upgrade command string.
+    """
+    try:
+        return _build_manual_upgrade_command(include_prerelease=False, is_uv=is_uv)
+    except Exception:
+        # Fallback: rebuild from shared command parts to avoid hardcoded strings.
+        try:
+            command_parts, _ = _build_command_parts(
+                package_name=PACKAGE_NAME,
+                is_uv=is_uv,
+                force_reinstall=False,
+                include_prerelease=False,
+            )
+        except Exception:
+            command_parts = (
+                ["uv", "tool", "install", "--upgrade", PACKAGE_NAME]
+                if is_uv
+                else ["pip", "install", "--upgrade", PACKAGE_NAME]
+            )
+        return " ".join(command_parts)
+
+
+def _show_proactive_uv_guidance(console: Console, is_uv: bool) -> None:
+    """Show proactive guidance for uv environments before update attempt.
+
+    Args:
+        console: Rich console for output.
+        is_uv: True if running in uv tool environment.
+    """
+    if not is_uv:
+        return
+
+    manual_cmd = _get_manual_upgrade_command(is_uv=True)
+    console.print(
+        f"[{INFO_STYLE}]💡 Detected uv tool environment.[/] "
+        f"If automatic update fails, run: [{ACCENT_STYLE}]{manual_cmd}[/]"
+    )
+
+
+def _show_error_guidance(console: Console, is_uv: bool) -> None:
+    """Show error guidance with correct manual command based on environment.
+
+    Args:
+        console: Rich console for output.
+        is_uv: True if running in uv tool environment.
+    """
+    try:
+        manual_cmd = _get_manual_upgrade_command(is_uv=is_uv)
+        console.print(f"[{INFO_STYLE}]💡 Tip:[/] Run this command manually:\n   [{ACCENT_STYLE}]{manual_cmd}[/]")
+    except Exception as exc:  # pragma: no cover - defensive guard
+        _LOGGER.debug("Failed to render update tip: %s", exc, exc_info=True)
+
+
 def _run_update_command(console: Console, ctx: Any) -> None:
     """Invoke the built-in update command and surface any errors."""
+    # Detect uv environment proactively before attempting update
+    is_uv = _is_uv_managed_environment()
+
+    # Provide proactive guidance for uv environments
+    # This helps users on older versions (e.g., 0.6.19) that don't have uv detection
+    # in their update command
+    _show_proactive_uv_guidance(console, is_uv)
+
     try:
         ctx.invoke(update_command)
     except click.ClickException as exc:
         exc.show()
         console.print(f"[{ERROR_STYLE}]Update command exited with an error.[/]")
-        # Provide additional context for uv environments
-        try:
-            if _is_uv_managed_environment():
-                manual_cmd = _build_manual_upgrade_command(include_prerelease=False, is_uv=True)
-                console.print(
-                    f"[{INFO_STYLE}]💡 Tip:[/] If automatic update failed, try running manually:\n"
-                    f"   [{ACCENT_STYLE}]{manual_cmd}[/]"
-                )
-        except Exception as exc:  # pragma: no cover - defensive guard
-            _LOGGER.debug("Failed to render uv update tip: %s", exc, exc_info=True)
+        _show_error_guidance(console, is_uv)
     except click.Abort:
         console.print(f"[{WARNING_STYLE}]Update aborted by user.[/]")
     except Exception as exc:  # pragma: no cover - defensive guard
         console.print(f"[{ERROR_STYLE}]Unexpected error while running update: {exc}[/]")
+        # Also provide guidance for unexpected errors in uv environments
+        if is_uv:
+            manual_cmd = _get_manual_upgrade_command(is_uv=True)
+            console.print(f"[{INFO_STYLE}]💡 Tip:[/] Try running manually:\n   [{ACCENT_STYLE}]{manual_cmd}[/]")
     else:
         _refresh_installed_version(console, ctx)
 

{glaip_sdk-0.6.20.dist-info → glaip_sdk-0.6.21.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: glaip-sdk
-Version: 0.6.20
+Version: 0.6.21
 Summary: Python SDK and CLI for GL AIP (GDP Labs AI Agent Package) - Build, run, and manage AI agents
 Author-email: Raymond Christopher <raymond.christopher@gdplabs.id>
 License: MIT
@@ -20,12 +20,12 @@ Requires-Dist: gllm-core-binary>=0.1.0
 Requires-Dist: langchain-core>=0.3.0
 Requires-Dist: gllm-tools-binary>=0.1.3
 Provides-Extra: local
-Requires-Dist: aip-agents-binary[local]>=0.5.14; (python_version >= "3.11" and python_version < "3.13") and extra == "local"
+Requires-Dist: aip-agents-binary[local]>=0.5.16; (python_version >= "3.11" and python_version < "3.13") and extra == "local"
 Requires-Dist: wrapt>=1.17.0; (python_version >= "3.11" and python_version < "3.13") and extra == "local"
 Provides-Extra: memory
-Requires-Dist: aip-agents-binary[memory]>=0.5.14; (python_version >= "3.11" and python_version < "3.13") and extra == "memory"
+Requires-Dist: aip-agents-binary[memory]>=0.5.16; (python_version >= "3.11" and python_version < "3.13") and extra == "memory"
 Provides-Extra: privacy
-Requires-Dist: aip-agents-binary[privacy]>=0.5.14; (python_version >= "3.11" and python_version < "3.13") and extra == "privacy"
+Requires-Dist: aip-agents-binary[privacy]>=0.5.16; (python_version >= "3.11" and python_version < "3.13") and extra == "privacy"
 Requires-Dist: en-core-web-sm; extra == "privacy"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"

{glaip_sdk-0.6.20.dist-info → glaip_sdk-0.6.21.dist-info}/RECORD

@@ -16,13 +16,13 @@ glaip_sdk/cli/context.py,sha256=--Y5vc6lgoAV7cRoUAr9UxSQaLmkMg29FolA7EwoRqM,3803
 glaip_sdk/cli/display.py,sha256=ojgWdGeD5KUnGOmWNqqK4JP-1EaWHWX--DWze3BmIz0,12137
 glaip_sdk/cli/hints.py,sha256=ca4krG103IS43s5BSLr0-N7uRMpte1_LY4nAXVvgDxo,1596
 glaip_sdk/cli/io.py,sha256=ChP6CRKbtuENsNomNEaMDfPDU0iqO-WuVvl4_y7F2io,3871
-glaip_sdk/cli/main.py,sha256=vQ8YcsFT4tG0xXCsJdS1WEWHK6ojiQS6pWIRWiW9PnA,23275
+glaip_sdk/cli/main.py,sha256=NRmFZTPayDJGZMHy2TF9BXj2CQWpTEfg2SWj_4zSdUc,24047
 glaip_sdk/cli/masking.py,sha256=2lrXQ-pfL7N-vNEQRT1s4Xq3JPDPDT8RC61OdaTtkkc,4060
 glaip_sdk/cli/mcp_validators.py,sha256=cwbz7p_p7_9xVuuF96OBQOdmEgo5UObU6iWWQ2X03PI,10047
 glaip_sdk/cli/pager.py,sha256=XygkAB6UW3bte7I4KmK7-PUGCJiq2Pv-4-MfyXAmXCw,7925
 glaip_sdk/cli/resolution.py,sha256=K-VaEHm9SYY_qfb9538VNHykL4_2N6F8iQqI1zMx_64,2402
 glaip_sdk/cli/rich_helpers.py,sha256=kO47N8e506rxrN6Oc9mbAWN3Qb536oQPWZy1s9A616g,819
-glaip_sdk/cli/update_notifier.py,sha256=Wbe_6WD_iQKq1GvoFS_vdcD_PIfj1LGCXMf0on2jKMY,10732
+glaip_sdk/cli/update_notifier.py,sha256=XtAZbIpO-h0bHUNHN0a4rvnt0mn4ckOX3dwOejN8chs,12929
 glaip_sdk/cli/utils.py,sha256=iemmKkpPndoZFBasoVqV7QArplchtr08yYWLA2efMzg,11996
 glaip_sdk/cli/validators.py,sha256=d-kq4y7HWMo6Gc7wLXWUsCt8JwFvJX_roZqRm1Nko1I,5622
 glaip_sdk/cli/commands/__init__.py,sha256=6Z3ASXDut0lAbUX_umBFtxPzzFyqoiZfVeTahThFu1A,219
@@ -34,7 +34,7 @@ glaip_sdk/cli/commands/mcps.py,sha256=tttqQnfM89iI9Pm94u8YRhiHMQNYNouecFX0brsT4c
 glaip_sdk/cli/commands/models.py,sha256=vfcGprK5CHprQ0CNpNzQlNNTELvdgKC7JxTG_ijOwmE,2009
 glaip_sdk/cli/commands/tools.py,sha256=_VBqG-vIjnn-gqvDlSTvcU7_F4N3ANGGKEECcQVR-BM,18430
 glaip_sdk/cli/commands/transcripts.py,sha256=ofxZLus1xLB061NxrLo1J6LPEb2VIxJTjmz7hLKgPmc,26377
-glaip_sdk/cli/commands/update.py,sha256=BZJ_E0iF0K9n6EupQAqjTSzUP4GPmq5ybqhx5i-_xQ0,4611
+glaip_sdk/cli/commands/update.py,sha256=SMO_Hr9WEolqvpFhEXY3TboBLHBfXIvBvwovbONEs7Y,6329
 glaip_sdk/cli/core/__init__.py,sha256=HTQqpijKNts6bYnwY97rpP3J324phoQmGFi6OXqi0E4,2116
 glaip_sdk/cli/core/context.py,sha256=I22z5IhZ09g5FPtMycDGU9Aj20Qv3TOQLhA5enaU2qk,3970
 glaip_sdk/cli/core/output.py,sha256=hj5F1M_rEqr4CChmdyW1QzGiWL0Mwzf-BFw-d6pjhjY,28304
@@ -156,8 +156,8 @@ glaip_sdk/utils/rendering/steps/format.py,sha256=Chnq7OBaj8XMeBntSBxrX5zSmrYeGcO
 glaip_sdk/utils/rendering/steps/manager.py,sha256=BiBmTeQMQhjRMykgICXsXNYh1hGsss-fH9BIGVMWFi0,13194
 glaip_sdk/utils/rendering/viewer/__init__.py,sha256=XrxmE2cMAozqrzo1jtDFm8HqNtvDcYi2mAhXLXn5CjI,457
 glaip_sdk/utils/rendering/viewer/presenter.py,sha256=mlLMTjnyeyPVtsyrAbz1BJu9lFGQSlS-voZ-_Cuugv0,5725
-glaip_sdk-0.6.20.dist-info/METADATA,sha256=m7NqyPGjDfUjM7TCsH_KcD_NSlQKW3-BesUIpYdEq5g,8455
-glaip_sdk-0.6.20.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-glaip_sdk-0.6.20.dist-info/entry_points.txt,sha256=65vNPUggyYnVGhuw7RhNJ8Fp2jygTcX0yxJBcBY3iLU,48
-glaip_sdk-0.6.20.dist-info/top_level.txt,sha256=td7yXttiYX2s94-4wFhv-5KdT0rSZ-pnJRSire341hw,10
-glaip_sdk-0.6.20.dist-info/RECORD,,
+glaip_sdk-0.6.21.dist-info/METADATA,sha256=67DVFObOYjE67Eq16lYSj-qVo7OOq89SWbb7FdXYDbw,8455
+glaip_sdk-0.6.21.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+glaip_sdk-0.6.21.dist-info/entry_points.txt,sha256=65vNPUggyYnVGhuw7RhNJ8Fp2jygTcX0yxJBcBY3iLU,48
+glaip_sdk-0.6.21.dist-info/top_level.txt,sha256=td7yXttiYX2s94-4wFhv-5KdT0rSZ-pnJRSire341hw,10
+glaip_sdk-0.6.21.dist-info/RECORD,,