glaip-sdk 0.0.20__py3-none-any.whl → 0.7.7__py3-none-any.whl

glaip_sdk/__init__.py

@@ -4,9 +4,49 @@ 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__
-from glaip_sdk.client import Client
-from glaip_sdk.exceptions import AIPError
-from glaip_sdk.models import MCP, Agent, Tool
 
-__all__ = ["MCP", "AIPError", "Agent", "Client", "Tool", "__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

@@ -14,6 +14,14 @@ 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"
 
 
@@ -47,9 +55,7 @@ def _try_get_dev_version() -> str | None:
             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")
+        ver = data.get("project", {}).get("version") or data.get("tool", {}).get("poetry", {}).get("version")
         if isinstance(ver, str) and ver:
             return ver
     except Exception:
@@ -58,6 +64,7 @@ def _try_get_dev_version() -> str | 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:

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",
+]