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

glaip_sdk/cli/commands/update.py

@@ -18,19 +18,89 @@ from glaip_sdk.branding import ACCENT_STYLE, ERROR_STYLE, INFO_STYLE, SUCCESS_ST
 PACKAGE_NAME = "glaip-sdk"
 
 
-def _build_upgrade_command(include_prerelease: bool) -> Sequence[str]:
-    """Return the pip command used to upgrade the SDK."""
-    command = [
-        sys.executable,
-        "-m",
-        "pip",
-        "install",
-        "--upgrade",
-        PACKAGE_NAME,
-    ]
+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.
+    """
+    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
+
+
+def _build_command_parts(
+    *,
+    package_name: str = PACKAGE_NAME,
+    is_uv: bool | None = None,
+    force_reinstall: bool = False,
+    include_prerelease: bool = False,
+) -> tuple[list[str], str]:
+    """Build the common parts of upgrade commands.
+
+    Returns:
+        Tuple of (command parts list, force_reinstall flag name).
+        For uv: (["uv", "tool", "install", "--upgrade", package_name], "--reinstall")
+        For pip: (["pip", "install", "--upgrade", package_name], "--force-reinstall")
+    """
+    if is_uv is None:
+        is_uv = _is_uv_managed_environment()
+
+    if is_uv:
+        command = ["uv", "tool", "install", "--upgrade", package_name]
+        reinstall_flag = "--reinstall"
+    else:
+        command = ["pip", "install", "--upgrade", package_name]
+        reinstall_flag = "--force-reinstall"
+
+    if force_reinstall:
+        command.insert(-1, reinstall_flag)
+
     if include_prerelease:
         command.append("--pre")
-    return command
+
+    return command, reinstall_flag
+
+
+def _build_upgrade_command(
+    include_prerelease: bool,
+    *,
+    package_name: str = PACKAGE_NAME,
+    is_uv: bool | None = None,
+    force_reinstall: bool = False,
+) -> Sequence[str]:
+    """Return the command used to upgrade the SDK (pip or uv tool install)."""
+    if is_uv is None:
+        is_uv = _is_uv_managed_environment()
+
+    command_parts, _ = _build_command_parts(
+        package_name=package_name,
+        is_uv=is_uv,
+        force_reinstall=force_reinstall,
+        include_prerelease=include_prerelease,
+    )
+
+    # For pip, prepend sys.executable and -m
+    if not is_uv:
+        command_parts = [sys.executable, "-m"] + command_parts
+
+    return command_parts
+
+
+def _build_manual_upgrade_command(
+    include_prerelease: bool,
+    *,
+    package_name: str = PACKAGE_NAME,
+    is_uv: bool | None = None,
+    force_reinstall: bool = False,
+) -> str:
+    """Return a manual upgrade command string matching the active environment."""
+    command_parts, _ = _build_command_parts(
+        package_name=package_name,
+        is_uv=is_uv,
+        force_reinstall=force_reinstall,
+        include_prerelease=include_prerelease,
+    )
+    return " ".join(command_parts)
 
 
 @click.command(name="update")
@@ -41,21 +111,31 @@ def _build_upgrade_command(include_prerelease: bool) -> Sequence[str]:
     help="Include pre-release versions when upgrading.",
 )
 def update_command(include_prerelease: bool) -> None:
-    """Upgrade the glaip-sdk package using pip."""
+    """Upgrade the glaip-sdk package using pip or uv tool install."""
     console = Console()
-    upgrade_cmd = _build_upgrade_command(include_prerelease)
+    # Call _is_uv_managed_environment() once and pass explicitly to avoid redundant calls
+    is_uv = _is_uv_managed_environment()
+    upgrade_cmd = _build_upgrade_command(include_prerelease, is_uv=is_uv)
+
+    # Determine the appropriate manual command for error messages
+    manual_cmd = _build_manual_upgrade_command(include_prerelease, is_uv=is_uv)
+
     console.print(f"[{ACCENT_STYLE}]Upgrading {PACKAGE_NAME} using[/] [{INFO_STYLE}]{' '.join(upgrade_cmd)}[/]")
 
     try:
         subprocess.run(upgrade_cmd, check=True)
     except FileNotFoundError as exc:
+        if is_uv:
+            raise click.ClickException(
+                f"Unable to locate uv executable. Please ensure uv is installed and on your PATH.\n"
+                f"Install uv: curl -LsSf https://astral.sh/uv/install.sh | sh\n"
+                f"Or run manually: {manual_cmd}"
+            ) from exc
         raise click.ClickException(
             "Unable to locate Python executable to run pip. Please ensure Python is installed and try again."
         ) from exc
     except subprocess.CalledProcessError as exc:
-        console.print(
-            f"[{ERROR_STYLE}]Automatic upgrade failed.[/] Please run `pip install -U {PACKAGE_NAME}` manually."
-        )
+        console.print(f"[{ERROR_STYLE}]Automatic upgrade failed.[/] Please run `{manual_cmd}` manually.")
         raise click.ClickException("Automatic upgrade failed.") from exc
 
     console.print(f"[{SUCCESS_STYLE}]✅ {PACKAGE_NAME} upgraded successfully.[/]")

glaip_sdk/cli/main.py

@@ -35,7 +35,12 @@ from glaip_sdk.cli.commands.mcps import mcps_group
 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_upgrade_command, update_command
+from glaip_sdk.cli.commands.update import (
+    _build_manual_upgrade_command,
+    _build_upgrade_command,
+    _is_uv_managed_environment,
+    update_command,
+)
 from glaip_sdk.cli.config import load_config
 from glaip_sdk.cli.hints import in_slash_mode
 from glaip_sdk.cli.transcript import get_transcript_cache_stats
@@ -549,13 +554,24 @@ def update(check_only: bool, force: bool) -> None:
             ),
         )
 
-        # Update using pip
+        # Update using pip or uv tool install
         try:
-            cmd = list(_build_upgrade_command(include_prerelease=False))
-            # Replace package name with "glaip-sdk" (main.py uses different name)
-            cmd[-1] = "glaip-sdk"
-            if force:
-                cmd.insert(5, "--force-reinstall")
+            is_uv = _is_uv_managed_environment()
+            cmd = list(
+                _build_upgrade_command(
+                    include_prerelease=False,
+                    package_name="glaip-sdk",
+                    is_uv=is_uv,
+                    force_reinstall=force,
+                )
+            )
+
+            manual_cmd = _build_manual_upgrade_command(
+                include_prerelease=False,
+                package_name="glaip-sdk",
+                is_uv=is_uv,
+                force_reinstall=force,
+            )
             subprocess.run(cmd, capture_output=True, text=True, check=True)
 
             verify_hint = ""
@@ -582,15 +598,35 @@ def update(check_only: bool, force: bool) -> None:
             )
             console.print(f"📋 New version: {version_result.stdout.strip()}")
 
+        except FileNotFoundError:
+            troubleshooting = f"💡 Troubleshooting:\n   • Try running: {manual_cmd}\n"
+            if is_uv:
+                troubleshooting += "   • Ensure uv is installed: curl -LsSf https://astral.sh/uv/install.sh | sh"
+                error_detail = "uv executable not found in your PATH."
+            else:
+                troubleshooting += "   • Ensure Python and pip are installed"
+                error_detail = "Python executable not found to run pip."
+            console.print(
+                AIPPanel(
+                    f"[{ERROR_STYLE}]❌ Update failed[/]\n\n🔍 Error: {error_detail}\n\n{troubleshooting}",
+                    title="❌ Update Error",
+                    border_style=ERROR,
+                    padding=(0, 1),
+                ),
+            )
+            sys.exit(1)
         except subprocess.CalledProcessError as e:
+            troubleshooting = (
+                f"💡 Troubleshooting:\n   • Check your internet connection\n   • Try running: {manual_cmd}\n"
+            )
+            if is_uv:
+                troubleshooting += "   • Ensure uv is installed: curl -LsSf https://astral.sh/uv/install.sh | sh"
+            else:
+                troubleshooting += "   • Check if you have write permissions"
+
             console.print(
                 AIPPanel(
-                    f"[{ERROR_STYLE}]❌ Update failed[/]\n\n"
-                    f"🔍 Error: {e.stderr}\n\n"
-                    "💡 Troubleshooting:\n"
-                    "   • Check your internet connection\n"
-                    "   • Try running: pip install --upgrade glaip-sdk\n"
-                    "   • Check if you have write permissions",
+                    f"[{ERROR_STYLE}]❌ Update failed[/]\n\n🔍 Error: {e.stderr}\n\n{troubleshooting}",
                     title="❌ Update Error",
                     border_style=ERROR,
                     padding=(0, 1),

glaip_sdk/cli/update_notifier.py

@@ -22,10 +22,15 @@ from rich.console import Console
 from glaip_sdk.branding import (
     ACCENT_STYLE,
     ERROR_STYLE,
+    INFO_STYLE,
     SUCCESS_STYLE,
     WARNING_STYLE,
 )
-from glaip_sdk.cli.commands.update import update_command
+from glaip_sdk.cli.commands.update import (
+    _build_manual_upgrade_command,
+    _is_uv_managed_environment,
+    update_command,
+)
 from glaip_sdk.cli.constants import UPDATE_CHECK_ENABLED
 from glaip_sdk.cli.hints import format_command_hint
 from glaip_sdk.cli.utils import command_hint
@@ -221,6 +226,16 @@ def _run_update_command(console: Console, ctx: Any) -> None:
     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)
     except click.Abort:
         console.print(f"[{WARNING_STYLE}]Update aborted by user.[/]")
     except Exception as exc:  # pragma: no cover - defensive guard

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

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: glaip-sdk
-Version: 0.6.18
-Summary: Python SDK for GL AIP (GDP Labs AI Agent Package) - Simplified CLI Design
+Version: 0.6.20
+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
 Requires-Python: <3.13,>=3.11
@@ -19,11 +19,13 @@ Requires-Dist: textual>=0.52.0
 Requires-Dist: gllm-core-binary>=0.1.0
 Requires-Dist: langchain-core>=0.3.0
 Requires-Dist: gllm-tools-binary>=0.1.3
-Requires-Dist: aip-agents-binary[local]>=0.5.13
+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: 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.13; (python_version >= "3.11" and python_version < "3.13") and extra == "memory"
+Requires-Dist: aip-agents-binary[memory]>=0.5.14; (python_version >= "3.11" and python_version < "3.13") and extra == "memory"
 Provides-Extra: privacy
-Requires-Dist: aip-agents-binary[privacy]>=0.5.13; (python_version >= "3.11" and python_version < "3.13") and 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: en-core-web-sm; extra == "privacy"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
@@ -48,16 +50,27 @@ GL stands for **GDP Labs**—GL AIP is our AI Agents Package for building, runni
 
 ### Installation
 
+Installing `glaip-sdk` provides both the **Python SDK** and the **`aip` CLI command** in a single package.
+
 ```bash
 # Using pip (recommended)
 pip install --upgrade glaip-sdk
 
 # Using uv (fast alternative)
 uv tool install glaip-sdk
+
+# Using pipx (CLI-focused, isolated environment)
+pipx install glaip-sdk
 ```
 
 **Requirements**: Python 3.11 or 3.12
 
+**Updating**: The `aip` CLI automatically detects your installation method and uses the correct update command:
+
+- If installed via `pip`: Uses `pip install --upgrade glaip-sdk`
+- If installed via `uv tool install`: Uses `uv tool install --upgrade glaip-sdk`
+- You can also update manually using the same command you used to install
+
 ## 🐍 Hello World - Python SDK
 
 Perfect for building applications and integrations.

{glaip_sdk-0.6.18.dist-info → glaip_sdk-0.6.20.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=YBWAC6ehffLP_TXZkNBxPrIHN5RqsSD8GLeIZdRBoIg,21911
+glaip_sdk/cli/main.py,sha256=vQ8YcsFT4tG0xXCsJdS1WEWHK6ojiQS6pWIRWiW9PnA,23275
 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=FnTjzS8YT94RmP6c5aU_XNIyRi7FRHvAskMy-VJikl8,10064
+glaip_sdk/cli/update_notifier.py,sha256=Wbe_6WD_iQKq1GvoFS_vdcD_PIfj1LGCXMf0on2jKMY,10732
 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=rIZo_x-tvpvcwpQLpwYwso1ix6qTHuNNTL4egmn5fEM,1812
+glaip_sdk/cli/commands/update.py,sha256=BZJ_E0iF0K9n6EupQAqjTSzUP4GPmq5ybqhx5i-_xQ0,4611
 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.18.dist-info/METADATA,sha256=cPfNrNuml65FqIP1ZhrAp2AEiiipu3OADHcT345uI6g,7716
-glaip_sdk-0.6.18.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-glaip_sdk-0.6.18.dist-info/entry_points.txt,sha256=65vNPUggyYnVGhuw7RhNJ8Fp2jygTcX0yxJBcBY3iLU,48
-glaip_sdk-0.6.18.dist-info/top_level.txt,sha256=td7yXttiYX2s94-4wFhv-5KdT0rSZ-pnJRSire341hw,10
-glaip_sdk-0.6.18.dist-info/RECORD,,
+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,,