glaip-sdk 0.0.0b99__py3-none-any.whl

glaip_sdk/__init__.py

@@ -0,0 +1,52 @@
+"""GL AIP - Python SDK for GDP Labs AI Agent Package.
+
+Authors:
+    Raymond Christopher (raymond.christopher@gdplabs.id)
+"""
+
+from __future__ import annotations
+
+import importlib
+from typing import TYPE_CHECKING, Any
+
+from glaip_sdk._version import __version__
+
+if TYPE_CHECKING:  # pragma: no cover - import only for type checking
+    from glaip_sdk.agents import Agent
+    from glaip_sdk.client import Client
+    from glaip_sdk.exceptions import AIPError
+    from glaip_sdk.mcps import MCP
+    from glaip_sdk.tools import Tool
+
+__all__ = ["Client", "Agent", "Tool", "MCP", "AIPError", "__version__"]
+
+_LAZY_IMPORTS: dict[str, tuple[str, str]] = {
+    "Client": ("glaip_sdk.client", "Client"),
+    "Agent": ("glaip_sdk.agents", "Agent"),
+    "Tool": ("glaip_sdk.tools", "Tool"),
+    "MCP": ("glaip_sdk.mcps", "MCP"),
+    "AIPError": ("glaip_sdk.exceptions", "AIPError"),
+}
+
+
+def __getattr__(name: str) -> Any:
+    """Lazy attribute access for public SDK symbols to defer heavy imports."""
+    if name == "__version__":
+        # Import __version__ when accessed via __getattr__
+        # This ensures coverage even if __version__ was removed from __dict__ for testing
+        from glaip_sdk._version import __version__ as version  # noqa: PLC0415
+
+        globals()["__version__"] = version
+        return version
+    if name in _LAZY_IMPORTS:
+        module_path, attr_name = _LAZY_IMPORTS[name]
+        module = importlib.import_module(module_path)
+        attr = getattr(module, attr_name)
+        globals()[name] = attr
+        return attr
+    raise AttributeError(f"module 'glaip_sdk' has no attribute {name!r}")
+
+
+def __dir__() -> list[str]:
+    """Return module attributes for dir()."""
+    return sorted(__all__)

glaip_sdk/_version.py

@@ -0,0 +1,81 @@
+"""Central version definition for glaip_sdk.
+
+Resolves from installed package metadata to avoid hardcoding.
+Falls back to a dev marker when running from source without installation.
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+try:
+    from importlib.metadata import PackageNotFoundError, version  # Python 3.8+
+except Exception:  # pragma: no cover - extremely unlikely
+    PackageNotFoundError = Exception  # type: ignore
+
+    def version(_: str) -> str:  # type: ignore
+        """Fallback version function when importlib.metadata is unavailable.
+
+        Args:
+            _: Package name (ignored in fallback).
+
+        Returns:
+            Default dev version string.
+        """
+        return "0.0.0.dev0"
+
+
+try:
+    import tomllib as _toml  # Python 3.11+
+except Exception:  # pragma: no cover
+    try:
+        import tomli as _toml  # type: ignore
+    except Exception:  # pragma: no cover
+        _toml = None  # type: ignore
+
+
+def _try_get_installed_version() -> str | None:
+    """Try to get version from installed package."""
+    try:
+        return version("glaip-sdk")
+    except PackageNotFoundError:
+        return None
+
+
+def _try_get_dev_version() -> str | None:
+    """Try to get version from local pyproject.toml for development."""
+    if _toml is None:
+        return None
+
+    try:
+        here = Path(__file__).resolve()
+        root = here.parent.parent  # project root (contains pyproject.toml)
+        pyproject = root / "pyproject.toml"
+        if not pyproject.is_file():
+            return None
+
+        data = _toml.loads(pyproject.read_text(encoding="utf-8"))
+        ver = data.get("project", {}).get("version") or data.get("tool", {}).get("poetry", {}).get("version")
+        if isinstance(ver, str) and ver:
+            return ver
+    except Exception:
+        pass
+    return None
+
+
+def _get_version() -> str:
+    """Return the SDK version from install metadata or fallbacks."""
+    # Try installed version first
+    installed_version = _try_get_installed_version()
+    if installed_version:
+        return installed_version
+
+    # Try development version
+    dev_version = _try_get_dev_version()
+    if dev_version:
+        return dev_version
+
+    return "0.0.0.dev0"
+
+
+__version__ = _get_version()

glaip_sdk/agents/__init__.py

@@ -0,0 +1,27 @@
+"""Agent package for GL AIP platform.
+
+This package provides the Agent class and AgentRegistry for deploying
+and managing AI agents on the GL AIP platform.
+
+Example:
+    >>> from glaip_sdk.agents import Agent, get_agent_registry
+    >>> agent = Agent(name="my_agent", instruction="Be helpful")
+    >>> deployed = agent.deploy()
+"""
+
+from __future__ import annotations
+
+from glaip_sdk.agents.base import Agent
+from glaip_sdk.registry.agent import AgentRegistry, get_agent_registry
+from glaip_sdk.registry.mcp import MCPRegistry, get_mcp_registry
+from glaip_sdk.registry.tool import ToolRegistry, get_tool_registry
+
+__all__ = [
+    "Agent",
+    "AgentRegistry",
+    "get_agent_registry",
+    "MCPRegistry",
+    "get_mcp_registry",
+    "ToolRegistry",
+    "get_tool_registry",
+]