aip-agents-binary 0.5.20__py3-none-macosx_13_0_arm64.whl → 0.5.22__py3-none-macosx_13_0_arm64.whl

aip_agents/examples/{hello_world_langgraph_bosa_twitter.py → hello_world_langgraph_gl_connector_twitter.py}

@@ -1,4 +1,4 @@
-"""Minimal LangGraph agent with bosa support example demonstrating asynchronous run.
+"""Minimal LangGraph agent with GL Connectors support example demonstrating asynchronous run.
 
 Authors:
     Saul Sayers (saul.sayers@gdplabs.id)
@@ -6,22 +6,24 @@ Authors:
 
 import asyncio
 
+from aip_agents.agent import LangGraphAgent
+from aip_agents.tools import GL_CONNECTORS_AUTOMATED_TOOLS
+from dotenv import load_dotenv
 from langchain_openai import ChatOpenAI
 
-from aip_agents.agent import LangGraphAgent
-from aip_agents.tools import BOSA_AUTOMATED_TOOLS
+load_dotenv(override=True)
 
 
-async def langgraph_bosa_example():
+async def langgraph_gl_connector_example():
     """Demonstrates the LangGraphAgent's arun method."""
     model = ChatOpenAI(model="gpt-4.1", temperature=0)
-    agent_name = "BOSAConnectorTwitterAgent"
+    agent_name = "GLConnectorTwitterAgent"
 
     langgraph_agent = LangGraphAgent(
         name=agent_name,
-        instruction="You are a helpful assistant that use BOSA connector to connect with Twitter API.",
+        instruction="You are a helpful assistant that uses GL Connectors to connect with the Twitter API.",
         model=model,
-        tools=BOSA_AUTOMATED_TOOLS["twitter"],
+        tools=GL_CONNECTORS_AUTOMATED_TOOLS["twitter"],
     )
 
     query = "Get 3 tweets about the latest Air India Incident"
@@ -38,4 +40,4 @@ async def langgraph_bosa_example():
 
 
 if __name__ == "__main__":
-    asyncio.run(langgraph_bosa_example())
+    asyncio.run(langgraph_gl_connector_example())

aip_agents/examples/hello_world_langgraph_gl_connector_twitter.pyi

@@ -0,0 +1,5 @@
+from aip_agents.agent import LangGraphAgent as LangGraphAgent
+from aip_agents.tools import GL_CONNECTORS_AUTOMATED_TOOLS as GL_CONNECTORS_AUTOMATED_TOOLS
+
+async def langgraph_gl_connector_example() -> None:
+    """Demonstrates the LangGraphAgent's arun method."""

aip_agents/examples/hello_world_sentry.py

@@ -1,4 +1,4 @@
-"""This is a simple FastAPI app to test Sentry with Open Telemetry from BOSA SDK.
+"""This is a simple FastAPI app to test Sentry with Open Telemetry from GL Connectors SDK.
 
 To run this example, make sure to set the following environment variables:
     SENTRY_DSN
@@ -20,13 +20,12 @@ import threading
 import time
 
 import uvicorn
-from fastapi import FastAPI
-from fastapi.responses import JSONResponse
-from fastapi.staticfiles import StaticFiles
-
 from aip_agents.examples.hello_world_langgraph import langgraph_example
 from aip_agents.sentry import setup_telemetry
 from aip_agents.utils.logger import get_logger
+from fastapi import FastAPI
+from fastapi.responses import JSONResponse
+from fastapi.staticfiles import StaticFiles
 
 logger = get_logger(__name__)
 
@@ -50,7 +49,9 @@ def fetch_endpoints():
             # Because using request.get() will trigger sentry, but the ep name is not saved.
             # Instead of GET /langgraph-hello-world, sentry will save it as GET
             url = f"http://127.0.0.1:8585{ep}"
-            result = subprocess.run(["curl", "-i", url], capture_output=True, text=True, check=False)
+            result = subprocess.run(
+                ["curl", "-i", url], capture_output=True, text=True, check=False
+            )
             logger.info(result.stdout)
         except Exception as e:
             logger.error(f"Error fetching {ep}: {e}")
@@ -63,7 +64,7 @@ def create_app() -> FastAPI:
         FastAPI: The configured FastAPI application.
     """
     app = FastAPI(
-        title="Bosa SDK - Sentry with Open Telemetry",
+        title="GL Connectors SDK - Sentry with Open Telemetry",
         description="This is a simple FastAPI app to test Sentry with Open Telemetry.",
         version="0.0.1",
         docs_url=None,

aip_agents/sentry/__init__.py

@@ -1,4 +1,4 @@
-"""This module provides a centralized way to handle Sentry and OpenTelemetry configuration for BOSA SDK.
+"""This module provides a centralized way to handle Sentry and OpenTelemetry configuration for GL Connectors SDK.
 
 Authors:
     Saul Sayers (saul.sayers@gdplabs.id)

aip_agents/sentry/sentry.py

@@ -1,4 +1,4 @@
-"""This file contains the Sentry and OpenTelemetry configuration for BOSA SDK.
+"""This file contains the Sentry and OpenTelemetry configuration for GL Connectors SDK.
 
 Authors:
     Saul Sayers (saul.sayers@gdplabs.id)
@@ -7,6 +7,8 @@ Authors:
 import inspect
 import os
 
+from aip_agents.agent import BaseAgent, GoogleADKAgent, LangChainAgent, LangGraphAgent
+from aip_agents.utils.logger import get_logger
 from bosa_core.telemetry import (
     FastAPIConfig,
     OpenTelemetryConfig,
@@ -20,9 +22,6 @@ from bosa_core.telemetry.opentelemetry.instrument.functions import (
 from dotenv import load_dotenv
 from fastapi import FastAPI
 
-from aip_agents.agent import BaseAgent, GoogleADKAgent, LangChainAgent, LangGraphAgent
-from aip_agents.utils.logger import get_logger
-
 load_dotenv()
 
 
@@ -56,13 +55,17 @@ def get_all_methods(cls: type) -> list:
     for name, member in inspect.getmembers(cls):
         if name.startswith("_"):
             continue  # skip dunder and private
-        if inspect.isfunction(member) or inspect.ismethod(member) or inspect.iscoroutinefunction(member):
+        if (
+            inspect.isfunction(member)
+            or inspect.ismethod(member)
+            or inspect.iscoroutinefunction(member)
+        ):
             methods.append(member)
     return methods
 
 
-def instrument_bosa_functions() -> None:
-    """Instrument BOSA functions."""
+def instrument_gl_functions() -> None:
+    """Instrument GL functions."""
     if BOSAFunctionsInstrumentor is None:
         return
     agent_methods = []
@@ -111,7 +114,9 @@ def setup_sentry_with_open_telemetry(app: FastAPI) -> None:
 
         telemetry_config = TelemetryConfig(sentry_config=sentry_config)
         init_telemetry(telemetry_config)
-        logger.info(f"Telemetry initialized with OpenTelemetry for environment: {SENTRY_ENVIRONMENT}")
+        logger.info(
+            f"Telemetry initialized with OpenTelemetry for environment: {SENTRY_ENVIRONMENT}"
+        )
     except Exception as e:
         logger.error(f"Failed to initialize telemetry with OpenTelemetry: {e}")
 
@@ -130,7 +135,9 @@ def setup_sentry_only() -> None:
 
         telemetry_config = TelemetryConfig(sentry_config=sentry_config)
         init_telemetry(telemetry_config)
-        logger.info(f"Telemetry initialized with Sentry only for environment: {SENTRY_ENVIRONMENT}")
+        logger.info(
+            f"Telemetry initialized with Sentry only for environment: {SENTRY_ENVIRONMENT}"
+        )
     except Exception as e:
         logger.error(f"Failed to initialize telemetry with Sentry only: {e}")
 
@@ -148,4 +155,4 @@ def setup_telemetry(app: FastAPI) -> None:
         setup_sentry_with_open_telemetry(app)
     else:
         setup_sentry_only()
-    instrument_bosa_functions()
+    instrument_gl_functions()

aip_agents/sentry/sentry.pyi

@@ -21,8 +21,8 @@ def get_all_methods(cls) -> list:
     Returns:
         list: A list of methods.
     """
-def instrument_bosa_functions() -> None:
-    """Instrument BOSA functions."""
+def instrument_gl_functions() -> None:
+    """Instrument GL functions."""
 def traces_sampler(*args) -> float:
     """Determine appropriate sampling rate for Sentry transactions.
 

aip_agents/tools/__init__.py

@@ -1,13 +1,23 @@
 """Initialize Tools Module for AIP Agents."""
 
 from importlib import import_module
+from typing import TYPE_CHECKING
 
-from aip_agents.tools.bosa_tools import BOSA_AUTOMATED_TOOLS
+from aip_agents.tools.gl_connector_tools import GL_CONNECTORS_AUTOMATED_TOOLS, BOSA_AUTOMATED_TOOLS
 from aip_agents.tools.gl_connector import GLConnectorTool
 from aip_agents.tools.time_tool import TimeTool
 from aip_agents.tools.web_search import GoogleSerperTool
+from aip_agents.utils.logger import get_logger
 
-__all__ = ["BOSA_AUTOMATED_TOOLS", "GLConnectorTool", "GoogleSerperTool", "TimeTool"]
+logger = get_logger(__name__)
+
+__all__ = [
+    "BOSA_AUTOMATED_TOOLS",
+    "GL_CONNECTORS_AUTOMATED_TOOLS",
+    "GLConnectorTool",
+    "GoogleSerperTool",
+    "TimeTool",
+]
 
 
 def _register_optional(module_path: str, export_name: str) -> None:
@@ -19,11 +29,16 @@ def _register_optional(module_path: str, export_name: str) -> None:
     """
     try:
         module = import_module(module_path)
-    except ImportError:
-        return
+        tool = getattr(module, export_name)
+        __all__.append(export_name)
+        globals()[export_name] = tool
 
-    globals()[export_name] = getattr(module, export_name)
-    __all__.append(export_name)
+    except ImportError as e:
+        logger.debug(f"Module {module_path} not found: {e}")
+    except AttributeError as e:
+        logger.debug(f"Tool {export_name} not found in module {module_path}: {e}")
+    except Exception as e:
+        logger.debug(f"Unexpected error loading {export_name}: {e}")
 
 
 _register_optional("aip_agents.tools.browser_use", "BrowserUseTool")
@@ -31,3 +46,8 @@ _register_optional("aip_agents.tools.code_sandbox", "E2BCodeSandboxTool")
 _register_optional("aip_agents.tools.document_loader", "DocxReaderTool")
 _register_optional("aip_agents.tools.document_loader", "ExcelReaderTool")
 _register_optional("aip_agents.tools.document_loader", "PDFReaderTool")
+
+if TYPE_CHECKING:
+    from aip_agents.tools.browser_use import BrowserUseTool
+    from aip_agents.tools.code_sandbox import E2BCodeSandboxTool
+    from aip_agents.tools.document_loader import DocxReaderTool, ExcelReaderTool, PDFReaderTool

aip_agents/tools/__init__.pyi

@@ -1,13 +1,9 @@
-from aip_agents.tools.bosa_tools import BOSA_AUTOMATED_TOOLS as BOSA_AUTOMATED_TOOLS
+from aip_agents.tools.browser_use import BrowserUseTool as BrowserUseTool
+from aip_agents.tools.code_sandbox import E2BCodeSandboxTool as E2BCodeSandboxTool
+from aip_agents.tools.document_loader import DocxReaderTool as DocxReaderTool, ExcelReaderTool as ExcelReaderTool, PDFReaderTool as PDFReaderTool
 from aip_agents.tools.gl_connector import GLConnectorTool as GLConnectorTool
+from aip_agents.tools.gl_connector_tools import BOSA_AUTOMATED_TOOLS as BOSA_AUTOMATED_TOOLS, GL_CONNECTORS_AUTOMATED_TOOLS as GL_CONNECTORS_AUTOMATED_TOOLS
 from aip_agents.tools.time_tool import TimeTool as TimeTool
 from aip_agents.tools.web_search import GoogleSerperTool as GoogleSerperTool
 
-__all__ = ['BOSA_AUTOMATED_TOOLS', 'GLConnectorTool', 'GoogleSerperTool', 'TimeTool', 'BrowserUseTool', 'E2BCodeSandboxTool', 'DocxReaderTool', 'ExcelReaderTool', 'PDFReaderTool']
-
-# Names in __all__ with no definition:
-#   BrowserUseTool
-#   DocxReaderTool
-#   E2BCodeSandboxTool
-#   ExcelReaderTool
-#   PDFReaderTool
+__all__ = ['BOSA_AUTOMATED_TOOLS', 'GL_CONNECTORS_AUTOMATED_TOOLS', 'GLConnectorTool', 'GoogleSerperTool', 'TimeTool', 'BrowserUseTool', 'E2BCodeSandboxTool', 'DocxReaderTool', 'ExcelReaderTool', 'PDFReaderTool']

aip_agents/tools/constants.py

@@ -1,4 +1,4 @@
-"""Constants for tools using BOSA Connector.
+"""Constants for tools using GL Connectors.
 
 Authors:
     Saul Sayers (saul.sayers@gdplabs.id)
@@ -7,20 +7,34 @@ Authors:
 import os
 from enum import Enum, StrEnum
 
-BOSA_API_BASE_URL = os.getenv("BOSA_API_BASE_URL")
-BOSA_API_KEY = os.getenv("BOSA_API_KEY")
-BOSA_FETCH_MAX_RETRIES = 3
+GL_CONNECTORS_BASE_URL = (
+    os.getenv("GL_CONNECTORS_BASE_URL")
+    or os.getenv("GL_CONNECTORS_API_BASE_URL")
+    or os.getenv("BOSA_API_BASE_URL")
+    or os.getenv("BOSA_BASE_URL")
+)
+GL_CONNECTORS_API_KEY = os.getenv("GL_CONNECTORS_API_KEY") or os.getenv("BOSA_API_KEY")
+GL_CONNECTORS_FETCH_MAX_RETRIES = int(
+    os.getenv("GL_CONNECTORS_FETCH_MAX_RETRIES")
+    or os.getenv("BOSA_FETCH_MAX_RETRIES")
+    or 3
+)
+
+# For backward compatibility
+BOSA_API_BASE_URL = GL_CONNECTORS_BASE_URL
+BOSA_API_KEY = GL_CONNECTORS_API_KEY
+BOSA_FETCH_MAX_RETRIES = GL_CONNECTORS_FETCH_MAX_RETRIES
 
 
 class ToolType(StrEnum):
-    """Tool types for BOSA Connector."""
+    """Tool types for GL Connectors."""
 
     GLLM = "gllm"
     LANGCHAIN = "langchain"
 
 
 class Action(Enum):
-    """Actions for BOSA Connector."""
+    """Actions for GL Connectors."""
 
     GITHUB = "github"
     GOOGLE = "google"
@@ -30,7 +44,7 @@ class Action(Enum):
 
 
 class GitHubEndpoint(Enum):
-    """GitHub endpoints for BOSA Connector."""
+    """GitHub endpoints for GL Connectors."""
 
     INTEGRATIONS = "integrations"
     USER_HAS_INTEGRATION = "integration-exists"
@@ -59,7 +73,7 @@ class GitHubEndpoint(Enum):
 
 
 class GoogleDriveEndpoint(Enum):
-    """Google Drive endpoints for BOSA Connector."""
+    """Google Drive endpoints for GL Connectors."""
 
     INTEGRATIONS = "integrations"
     USER_HAS_INTEGRATION = "integration-exists"
@@ -84,7 +98,7 @@ class GoogleDriveEndpoint(Enum):
 
 
 class GoogleDocsEndpoint(Enum):
-    """Google Docs endpoints for BOSA Connector."""
+    """Google Docs endpoints for GL Connectors."""
 
     INTEGRATIONS = "integrations"
     USER_HAS_INTEGRATION = "integration-exists"
@@ -100,7 +114,7 @@ class GoogleDocsEndpoint(Enum):
 
 
 class GoogleEndpoint(Enum):
-    """Google endpoints for BOSA Connector."""
+    """Google endpoints for GL Connectors."""
 
     INTEGRATIONS = "integrations"
     USER_HAS_INTEGRATION = "integration-exists"
@@ -109,7 +123,7 @@ class GoogleEndpoint(Enum):
 
 
 class TwitterEndpoint(Enum):
-    """Twitter endpoints for BOSA Connector."""
+    """Twitter endpoints for GL Connectors."""
 
     INTEGRATIONS = "integrations"
     USER_HAS_INTEGRATION = "integration-exists"
@@ -121,7 +135,7 @@ class TwitterEndpoint(Enum):
 
 
 class GoogleMailEndpoint(Enum):
-    """Google Mail endpoints for BOSA Connector."""
+    """Google Mail endpoints for GL Connectors."""
 
     INTEGRATIONS = "integrations"
     USER_HAS_INTEGRATION = "integration-exists"

aip_agents/tools/constants.pyi

@@ -1,17 +1,20 @@
 from _typeshed import Incomplete
 from enum import Enum, StrEnum
 
-BOSA_API_BASE_URL: Incomplete
-BOSA_API_KEY: Incomplete
-BOSA_FETCH_MAX_RETRIES: int
+GL_CONNECTORS_BASE_URL: Incomplete
+GL_CONNECTORS_API_KEY: Incomplete
+GL_CONNECTORS_FETCH_MAX_RETRIES: Incomplete
+BOSA_API_BASE_URL = GL_CONNECTORS_BASE_URL
+BOSA_API_KEY = GL_CONNECTORS_API_KEY
+BOSA_FETCH_MAX_RETRIES = GL_CONNECTORS_FETCH_MAX_RETRIES
 
 class ToolType(StrEnum):
-    """Tool types for BOSA Connector."""
+    """Tool types for GL Connectors."""
     GLLM: str
     LANGCHAIN: str
 
 class Action(Enum):
-    """Actions for BOSA Connector."""
+    """Actions for GL Connectors."""
     GITHUB: str
     GOOGLE: str
     GOOGLE_DRIVE: str
@@ -19,7 +22,7 @@ class Action(Enum):
     TWITTER: str
 
 class GitHubEndpoint(Enum):
-    """GitHub endpoints for BOSA Connector."""
+    """GitHub endpoints for GL Connectors."""
     INTEGRATIONS: str
     USER_HAS_INTEGRATION: str
     SUCCESS_AUTHORIZE_CALLBACK: str
@@ -46,7 +49,7 @@ class GitHubEndpoint(Enum):
     LIST_PROJECTS: str
 
 class GoogleDriveEndpoint(Enum):
-    """Google Drive endpoints for BOSA Connector."""
+    """Google Drive endpoints for GL Connectors."""
     INTEGRATIONS: str
     USER_HAS_INTEGRATION: str
     SUCCESS_AUTHORIZE_CALLBACK: str
@@ -69,7 +72,7 @@ class GoogleDriveEndpoint(Enum):
     DOWNLOAD_FILE: str
 
 class GoogleDocsEndpoint(Enum):
-    """Google Docs endpoints for BOSA Connector."""
+    """Google Docs endpoints for GL Connectors."""
     INTEGRATIONS: str
     USER_HAS_INTEGRATION: str
     SUCCESS_AUTHORIZE_CALLBACK: str
@@ -83,14 +86,14 @@ class GoogleDocsEndpoint(Enum):
     SUMMARIZE_COMMENTS: str
 
 class GoogleEndpoint(Enum):
-    """Google endpoints for BOSA Connector."""
+    """Google endpoints for GL Connectors."""
     INTEGRATIONS: str
     USER_HAS_INTEGRATION: str
     SUCCESS_AUTHORIZE_CALLBACK: str
     USERINFO: str
 
 class TwitterEndpoint(Enum):
-    """Twitter endpoints for BOSA Connector."""
+    """Twitter endpoints for GL Connectors."""
     INTEGRATIONS: str
     USER_HAS_INTEGRATION: str
     SUCCESS_AUTHORIZE_CALLBACK: str
@@ -100,7 +103,7 @@ class TwitterEndpoint(Enum):
     GET_USERS: str
 
 class GoogleMailEndpoint(Enum):
-    """Google Mail endpoints for BOSA Connector."""
+    """Google Mail endpoints for GL Connectors."""
     INTEGRATIONS: str
     USER_HAS_INTEGRATION: str
     SUCCESS_AUTHORIZE_CALLBACK: str

aip_agents/tools/gl_connector/__init__.py

@@ -1,4 +1,4 @@
-"""GL Connector tool wrapper exports."""
+"""GL Connectors tool wrapper exports."""
 
 from aip_agents.tools.gl_connector.tool import GLConnectorTool
 

aip_agents/tools/gl_connector/tool.py

@@ -1,7 +1,8 @@
-"""GL Connector tool wrapper for BOSA connector tools.
+"""Wrapper for GL Connectors.
 
 Authors:
     Saul Sayers (saul.sayers@gdplabs.id)
+    Christian Trisno Sen Long Chen (christian.t.s.l.chen@gdplabs.id)
 
 Reference:
     https://gl-docs.gitbook.io/bosa/gl-connector/gl-connector
@@ -13,19 +14,30 @@ import os
 from collections.abc import Iterable
 from typing import Any
 
+from aip_agents.tools.constants import ToolType
 from bosa_connectors import BosaConnector, BOSAConnectorToolGenerator
 from langchain_core.runnables import RunnableConfig
 from langchain_core.tools import BaseTool
 from pydantic import ConfigDict, PrivateAttr
 
-from aip_agents.tools.constants import ToolType
-
 _REQUIRED_ENV_VARS: tuple[str, ...] = (
-    "BOSA_BASE_URL",
-    "BOSA_API_KEY",
-    "BOSA_USERNAME",
-    "BOSA_PASSWORD",
+    "GL_CONNECTORS_BASE_URL",
+    "GL_CONNECTORS_API_KEY",
+    "GL_CONNECTORS_USERNAME",
+    "GL_CONNECTORS_PASSWORD",
 )
+
+_ENV_VAR_MAPPING: dict[str, tuple[str, ...]] = {
+    "GL_CONNECTORS_BASE_URL": (
+        "GL_CONNECTORS_BASE_URL",
+        "BOSA_BASE_URL",
+        "BOSA_API_BASE_URL",
+    ),
+    "GL_CONNECTORS_API_KEY": ("GL_CONNECTORS_API_KEY", "BOSA_API_KEY"),
+    "GL_CONNECTORS_USERNAME": ("GL_CONNECTORS_USERNAME", "BOSA_USERNAME"),
+    "GL_CONNECTORS_PASSWORD": ("GL_CONNECTORS_PASSWORD", "BOSA_PASSWORD"),
+    "GL_CONNECTORS_IDENTIFIER": ("GL_CONNECTORS_IDENTIFIER", "BOSA_IDENTIFIER"),
+}
 _TOP_LEVEL_KEYS: tuple[str, ...] = (
     "token",
     "identifier",
@@ -54,7 +66,9 @@ class _InjectedTool(BaseTool):
         Returns:
             None
         """
-        base_fields = {field: getattr(base_tool, field) for field in BaseTool.model_fields}
+        base_fields = {
+            field: getattr(base_tool, field) for field in BaseTool.model_fields
+        }
         super().__init__(**base_fields)
         self._base_tool = base_tool
         self._token = token
@@ -84,7 +98,9 @@ class _InjectedTool(BaseTool):
         """
         return await self._base_tool._arun(*args, **kwargs)
 
-    def invoke(self, input: Any, config: RunnableConfig | None = None, **kwargs: Any) -> Any:
+    def invoke(
+        self, input: Any, config: RunnableConfig | None = None, **kwargs: Any
+    ) -> Any:
         """Invoke the tool with token and optional identifier injected.
 
         Args:
@@ -98,7 +114,9 @@ class _InjectedTool(BaseTool):
         injected = _inject_params(input, self._token, self._identifier, self._base_tool)
         return super().invoke(injected, config=config, **kwargs)
 
-    async def ainvoke(self, input: Any, config: RunnableConfig | None = None, **kwargs: Any) -> Any:
+    async def ainvoke(
+        self, input: Any, config: RunnableConfig | None = None, **kwargs: Any
+    ) -> Any:
         """Invoke the tool asynchronously with token and optional identifier injected.
 
         Args:
@@ -122,7 +140,9 @@ class _InjectedTool(BaseTool):
         Returns:
             The result of running the tool with injected parameters.
         """
-        injected = _inject_params(tool_input, self._token, self._identifier, self._base_tool)
+        injected = _inject_params(
+            tool_input, self._token, self._identifier, self._base_tool
+        )
         return super().run(injected, **kwargs)
 
     async def arun(self, tool_input: Any, **kwargs: Any) -> Any:
@@ -135,7 +155,9 @@ class _InjectedTool(BaseTool):
         Returns:
             The result of running the tool with injected parameters.
         """
-        injected = _inject_params(tool_input, self._token, self._identifier, self._base_tool)
+        injected = _inject_params(
+            tool_input, self._token, self._identifier, self._base_tool
+        )
         return await super().arun(injected, **kwargs)
 
 
@@ -145,12 +167,12 @@ def GLConnectorTool(
     api_key: str | None = None,
     identifier: str | None = None,
 ) -> BaseTool:
-    """Create a single GL Connector tool by exact tool name.
+    """Create a single tool from GL Connectors by exact tool name.
 
     Args:
         tool_name: Exact tool name (not module name).
-        api_key: Optional override for BOSA API key.
-        identifier: Optional override for BOSA identifier.
+        api_key: Optional override for GL Connectors API key.
+        identifier: Optional override for GL Connectors identifier.
 
     Returns:
         A single LangChain BaseTool with token injection.
@@ -159,14 +181,17 @@ def GLConnectorTool(
         raise ValueError("tool_name must be a non-empty string")
 
     env_values = _load_env(api_key=api_key, identifier=identifier)
-    connector = BosaConnector(api_base_url=env_values["BOSA_BASE_URL"], api_key=env_values["BOSA_API_KEY"])
+    connector = BosaConnector(
+        api_base_url=env_values["GL_CONNECTORS_BASE_URL"],
+        api_key=env_values["GL_CONNECTORS_API_KEY"],
+    )
 
     modules = _get_available_modules(connector)
     module_name = _resolve_module(tool_name, modules)
 
     generator = BOSAConnectorToolGenerator(
-        api_base_url=env_values["BOSA_BASE_URL"],
-        api_key=env_values["BOSA_API_KEY"],
+        api_base_url=env_values["GL_CONNECTORS_BASE_URL"],
+        api_key=env_values["GL_CONNECTORS_API_KEY"],
         app_name=module_name,
     )
     tools = generator.generate_tools(tool_type=ToolType.LANGCHAIN)
@@ -175,18 +200,24 @@ def GLConnectorTool(
     if not matching:
         raise ValueError(f"Tool '{tool_name}' not found in module '{module_name}'")
     if len(matching) > 1:
-        raise ValueError(f"Multiple tools named '{tool_name}' found in module '{module_name}'")
-
-    token = _create_token(connector, env_values["BOSA_USERNAME"], env_values["BOSA_PASSWORD"])
-    return _InjectedTool(matching[0], token, env_values.get("BOSA_IDENTIFIER"))
+        raise ValueError(
+            f"Multiple tools named '{tool_name}' found in module '{module_name}'"
+        )
+
+    token = _create_token(
+        connector,
+        env_values["GL_CONNECTORS_USERNAME"],
+        env_values["GL_CONNECTORS_PASSWORD"],
+    )
+    return _InjectedTool(matching[0], token, env_values.get("GL_CONNECTORS_IDENTIFIER"))
 
 
 def _load_env(*, api_key: str | None, identifier: str | None) -> dict[str, str]:
     """Load and validate environment configuration for connector access.
 
     Args:
-        api_key: Optional override for BOSA API key.
-        identifier: Optional override for BOSA identifier.
+        api_key: Optional override for GL Connectors API key.
+        identifier: Optional override for GL Connectors identifier.
 
     Returns:
         Dictionary containing environment configuration values.
@@ -194,28 +225,42 @@ def _load_env(*, api_key: str | None, identifier: str | None) -> dict[str, str]:
     Raises:
         ValueError: If required environment variables are missing.
     """
-    env = {key: os.getenv(key) for key in _REQUIRED_ENV_VARS}
+    env: dict[str, str | None] = {}
 
-    resolved_api_key = api_key or env["BOSA_API_KEY"]
-    env["BOSA_API_KEY"] = resolved_api_key
+    # Load from environment using mapping (prefers GL_CONNECTORS_* over BOSA_*)
+    for internal_key, env_vars in _ENV_VAR_MAPPING.items():
+        val = None
+        for var_name in env_vars:
+            val = os.getenv(var_name)
+            if val:
+                break
+        env[internal_key] = val
 
-    optional_identifier = identifier or os.getenv("BOSA_IDENTIFIER")
+    if api_key:
+        env["GL_CONNECTORS_API_KEY"] = api_key
 
-    if optional_identifier:
-        env["BOSA_IDENTIFIER"] = optional_identifier
+    if identifier:
+        env["GL_CONNECTORS_IDENTIFIER"] = identifier
 
-    missing = [key for key, value in env.items() if key in _REQUIRED_ENV_VARS and not value]
+    missing = [key for key in _REQUIRED_ENV_VARS if not env.get(key)]
     if missing:
-        raise ValueError(f"Missing required environment variables: {', '.join(missing)}")
+        # Map back to human-friendly names for the error message
+        friendly_missing = []
+        for m in missing:
+            preferred = _ENV_VAR_MAPPING[m][0]
+            friendly_missing.append(preferred)
+        raise ValueError(
+            f"Missing required environment variables: {', '.join(friendly_missing)}"
+        )
 
-    return {key: value for key, value in env.items() if value is not None}
+    return {k: v for k, v in env.items() if v is not None}
 
 
 def _get_available_modules(connector: BosaConnector) -> list[str]:
     """Return available connector modules or raise an actionable error.
 
     Args:
-        connector: BOSA connector instance to query for modules.
+        connector: GL Connectors instance to query for modules.
 
     Returns:
         List of available module names.
@@ -246,13 +291,21 @@ def _resolve_module(tool_name: str, modules: Iterable[str]) -> str:
     Raises:
         ValueError: If no matching module is found or multiple ambiguous matches exist.
     """
-    candidates = [module for module in modules if tool_name == module or tool_name.startswith(f"{module}_")]
+    candidates = [
+        module
+        for module in modules
+        if tool_name == module or tool_name.startswith(f"{module}_")
+    ]
     if not candidates:
-        raise ValueError(f"Unable to resolve module for tool '{tool_name}'. Available modules: {', '.join(modules)}")
+        raise ValueError(
+            f"Unable to resolve module for tool '{tool_name}'. Available modules: {', '.join(modules)}"
+        )
 
     candidates.sort(key=len, reverse=True)
     if len(candidates) > 1 and len(candidates[0]) == len(candidates[1]):
-        raise ValueError(f"Ambiguous module match for tool '{tool_name}'. Matches: {', '.join(candidates)}")
+        raise ValueError(
+            f"Ambiguous module match for tool '{tool_name}'. Matches: {', '.join(candidates)}"
+        )
     return candidates[0]
 
 
@@ -260,9 +313,9 @@ def _create_token(connector: BosaConnector, username: str, password: str) -> str
     """Authenticate the connector user and return a user token.
 
     Args:
-        connector: BOSA connector instance for authentication.
-        username: BOSA username for authentication.
-        password: BOSA password for authentication.
+        connector: GL Connectors instance for authentication.
+        username: GL Connectors username for authentication.
+        password: GL Connectors password for authentication.
 
     Returns:
         Authentication token string.
@@ -273,15 +326,17 @@ def _create_token(connector: BosaConnector, username: str, password: str) -> str
     try:
         user = connector.authenticate_bosa_user(username, password)
     except Exception as exc:
-        raise ValueError("Failed to authenticate BOSA user") from exc
+        raise ValueError("Failed to authenticate GL Connectors user") from exc
 
     token = getattr(user, "token", None)
     if not token:
-        raise ValueError("BOSA user token missing after authentication")
+        raise ValueError("GL Connectors user token missing after authentication")
     return token
 
 
-def _inject_params(tool_input: Any, token: str, identifier: str | None, base_tool: BaseTool) -> dict[str, Any]:
+def _inject_params(
+    tool_input: Any, token: str, identifier: str | None, base_tool: BaseTool
+) -> dict[str, Any]:
     """Inject token and optional identifier into tool input.
 
     Args:
@@ -319,7 +374,9 @@ def _inject_params(tool_input: Any, token: str, identifier: str | None, base_too
     return injected
 
 
-def _wrap_request_if_needed(tool_input: dict[str, Any], base_tool: BaseTool) -> dict[str, Any]:
+def _wrap_request_if_needed(
+    tool_input: dict[str, Any], base_tool: BaseTool
+) -> dict[str, Any]:
     """Wrap flat inputs into a 'request' payload when required by schema.
 
     Args:
@@ -330,7 +387,9 @@ def _wrap_request_if_needed(tool_input: dict[str, Any], base_tool: BaseTool) ->
         Dictionary with inputs wrapped in 'request' key if needed, otherwise unchanged.
     """
     args_schema = getattr(base_tool, "args_schema", None)
-    if not (isinstance(args_schema, dict) and "request" in args_schema.get("properties", {})):
+    if not (
+        isinstance(args_schema, dict) and "request" in args_schema.get("properties", {})
+    ):
         return tool_input
 
     request_payload = {}

aip_agents/tools/gl_connector/tool.pyi

@@ -62,12 +62,12 @@ class _InjectedTool(BaseTool):
         """
 
 def GLConnectorTool(tool_name: str, *, api_key: str | None = None, identifier: str | None = None) -> BaseTool:
-    """Create a single GL Connector tool by exact tool name.
+    """Create a single tool from GL Connectors by exact tool name.
 
     Args:
         tool_name: Exact tool name (not module name).
-        api_key: Optional override for BOSA API key.
-        identifier: Optional override for BOSA identifier.
+        api_key: Optional override for GL Connectors API key.
+        identifier: Optional override for GL Connectors identifier.
 
     Returns:
         A single LangChain BaseTool with token injection.

aip_agents/tools/gl_connector_tools.py

@@ -0,0 +1,122 @@
+"""Auto-generated tools from GL Connectors.
+
+Authors:
+    Saul Sayers (saul.sayers@gdplabs.id)
+"""
+
+from aip_agents.tools.constants import (
+    GL_CONNECTORS_API_KEY,
+    GL_CONNECTORS_BASE_URL,
+    GL_CONNECTORS_FETCH_MAX_RETRIES,
+    ToolType,
+)
+from aip_agents.utils.logger import get_logger
+from bosa_connectors import BosaConnector, BOSAConnectorToolGenerator
+from langchain_core.tools import BaseTool
+
+logger = get_logger(__name__)
+
+
+def get_gl_connector_modules_with_retry() -> list[str]:
+    """Try to get available modules with retries.
+
+    Returns:
+        List of available modules.
+    """
+    if not GL_CONNECTORS_BASE_URL or not GL_CONNECTORS_API_KEY:
+        logger.warning(
+            "GL Connectors credentials missing (base_url or api_key); returning empty modules list"
+        )
+        return []
+
+    connector = BosaConnector(
+        api_base_url=GL_CONNECTORS_BASE_URL, api_key=GL_CONNECTORS_API_KEY
+    )
+    modules = []
+    for attempt in range(GL_CONNECTORS_FETCH_MAX_RETRIES):
+        try:
+            modules = list(connector.get_available_modules())
+            if modules:
+                return modules
+            logger.warning(
+                f"Failed to get GL Connectors available modules, retrying... (attempt {attempt + 1} / {GL_CONNECTORS_FETCH_MAX_RETRIES})"
+            )
+        except Exception as e:
+            logger.exception(
+                f"Exception when getting GL Connectors available modules (attempt {attempt + 1} / {GL_CONNECTORS_FETCH_MAX_RETRIES}): {e}"
+            )
+    logger.error("Failed to get GL Connectors available modules after maximum retries")
+    return modules
+
+
+class LazyGLConnectorToolsDict(dict):
+    """Lazy dictionary for GL Connectors."""
+
+    def __missing__(self, app):
+        """When a key is missing, create the tools and store them in the dictionary.
+
+        Args:
+            app: Name of the GL Connectors.
+
+        Returns:
+            List of tools generated by the GL Connectors tool generator.
+        """
+        if app not in get_gl_connector_modules():
+            return []
+        tools = []
+        for attempt in range(GL_CONNECTORS_FETCH_MAX_RETRIES):
+            try:
+                tools = BOSAConnectorToolGenerator(
+                    api_base_url=GL_CONNECTORS_BASE_URL,
+                    api_key=GL_CONNECTORS_API_KEY,
+                    app_name=app,
+                ).generate_tools(tool_type=ToolType.LANGCHAIN)
+                if tools:
+                    self[app] = tools
+                    return tools
+                logger.warning(
+                    f"Failed to create GL Connectors, retrying... (attempt {attempt + 1} / {GL_CONNECTORS_FETCH_MAX_RETRIES})"
+                )
+            except Exception as e:
+                logger.exception(
+                    f"Exception when creating GL Connectors for app '{app}' "
+                    f"(attempt {attempt + 1} / {GL_CONNECTORS_FETCH_MAX_RETRIES}): {e}"
+                )
+        logger.error("Failed to create GL Connectors after maximum retries")
+        return tools
+
+
+# Supported modules (dynamic)
+def get_gl_connector_modules() -> list[str]:
+    """Lazily fetch and cache GL Connectors modules.
+
+    Returns:
+        List of GL Connectors modules.
+    """
+    if not hasattr(get_gl_connector_modules, "_cache"):
+        get_gl_connector_modules._cache = get_gl_connector_modules_with_retry()
+    return get_gl_connector_modules._cache
+
+
+# FOR BACKWARDS COMPATIBILITY
+def get_bosa_modules() -> list[str]:
+    """Backward-compatible alias for get_gl_connector_modules."""
+    return get_gl_connector_modules()
+
+
+GL_CONNECTORS_MODULES = [
+    "github",
+    "twitter",
+    "google",
+    "google_drive",
+    "google_mail",
+    "google_docs",
+]
+
+# FOR BACKWARDS COMPATIBILITY
+BOSA_MODULES = GL_CONNECTORS_MODULES
+
+GL_CONNECTORS_AUTOMATED_TOOLS: dict[str, list[BaseTool]] = LazyGLConnectorToolsDict()
+
+# FOR BACKWARDS COMPATIBILITY
+BOSA_AUTOMATED_TOOLS = GL_CONNECTORS_AUTOMATED_TOOLS

aip_agents/tools/gl_connector_tools.pyi

@@ -0,0 +1,39 @@
+from _typeshed import Incomplete
+from aip_agents.tools.constants import GL_CONNECTORS_API_KEY as GL_CONNECTORS_API_KEY, GL_CONNECTORS_BASE_URL as GL_CONNECTORS_BASE_URL, GL_CONNECTORS_FETCH_MAX_RETRIES as GL_CONNECTORS_FETCH_MAX_RETRIES, ToolType as ToolType
+from aip_agents.utils.logger import get_logger as get_logger
+from langchain_core.tools import BaseTool as BaseTool
+
+logger: Incomplete
+
+def get_gl_connector_modules_with_retry() -> list[str]:
+    """Try to get available modules with retries.
+
+    Returns:
+        List of available modules.
+    """
+
+class LazyGLConnectorToolsDict(dict):
+    """Lazy dictionary for GL Connectors."""
+    def __missing__(self, app):
+        """When a key is missing, create the tools and store them in the dictionary.
+
+        Args:
+            app: Name of the GL Connectors.
+
+        Returns:
+            List of tools generated by the GL Connectors tool generator.
+        """
+
+def get_gl_connector_modules() -> list[str]:
+    """Lazily fetch and cache GL Connectors modules.
+
+    Returns:
+        List of GL Connectors modules.
+    """
+def get_bosa_modules() -> list[str]:
+    """Backward-compatible alias for get_gl_connector_modules."""
+
+GL_CONNECTORS_MODULES: Incomplete
+BOSA_MODULES = GL_CONNECTORS_MODULES
+GL_CONNECTORS_AUTOMATED_TOOLS: dict[str, list[BaseTool]]
+BOSA_AUTOMATED_TOOLS = GL_CONNECTORS_AUTOMATED_TOOLS

{aip_agents_binary-0.5.20.dist-info → aip_agents_binary-0.5.22.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aip-agents-binary
-Version: 0.5.20
+Version: 0.5.22
 Summary: A library for managing agents in Gen AI applications.
 Author-email: Raymond Christopher <raymond.christopher@gdplabs.id>
 Requires-Python: <3.13,>=3.11
@@ -159,9 +159,9 @@ Navigate to the library's root directory (e.g., `python/aip-agents` if you clone
 python aip_agents/examples/hello_world_langgraph.py
 ```
 
-**LangGraph with BOSA Connector (OpenAI):**
+**LangGraph with GL Connectors (OpenAI):**
 ```bash
-python aip_agents/examples/hello_world_langgraph_bosa_twitter.py
+python aip_agents/examples/hello_world_langgraph_gl_connector_twitter.py
 ```
 
 **LangGraph Streaming (OpenAI):**

{aip_agents_binary-0.5.20.dist-info → aip_agents_binary-0.5.22.dist-info}/RECORD

@@ -179,8 +179,8 @@ aip_agents/examples/hello_world_langflow_agent.py,sha256=NFgI_jJ0mDpeRpVhw5TESRS
 aip_agents/examples/hello_world_langflow_agent.pyi,sha256=sl3sF36CcY_s_zQ61gvneRyTiHmPV8p9xzPL2IeB1zo,1251
 aip_agents/examples/hello_world_langgraph.py,sha256=CSlZzVOtwbnCxw3uci_qGFzO7eYZe0uzs-4kmGNih7A,1248
 aip_agents/examples/hello_world_langgraph.pyi,sha256=ix3j1wqj79wkMMuOjEQUhZA4Isr5JSFEJw49WJ2NmM4,251
-aip_agents/examples/hello_world_langgraph_bosa_twitter.py,sha256=NmRmEU6bccPa7UNRw1RCxYrcgw6RaLU2HYgmfy6V4IY,1224
-aip_agents/examples/hello_world_langgraph_bosa_twitter.pyi,sha256=QSx4K8FDnQzedl3Cl5ZlngL1-HEjE7MiLSemQ2N0dsU,238
+aip_agents/examples/hello_world_langgraph_gl_connector_twitter.py,sha256=rZ517PtYjE9azJjtSOXkZgyc_g7pHejVS7Ij4gz-BqE,1327
+aip_agents/examples/hello_world_langgraph_gl_connector_twitter.pyi,sha256=zvvkXFJw8NV4W7B8XB4b4F3s-HKixsasSMfJAuteqoQ,264
 aip_agents/examples/hello_world_langgraph_mcp_http.py,sha256=BmfwomTLNbGH3jpMMxGmSV_waYuvfbtdYdeKqVVzEPw,1008
 aip_agents/examples/hello_world_langgraph_mcp_http.pyi,sha256=8Ye3T6ip-_qykUEsYz5oPrJ99Td89OvFYwTdiP6-hAk,264
 aip_agents/examples/hello_world_langgraph_mcp_http_stream.py,sha256=h2nkg-oeZvzFWF2k2LHvAOiUqfnpnGAk1sfK1JiVQlg,1129
@@ -209,7 +209,7 @@ aip_agents/examples/hello_world_multi_agent_langgraph_lm_invoker.py,sha256=sppLD
 aip_agents/examples/hello_world_multi_agent_langgraph_lm_invoker.pyi,sha256=zFNns9i-sPY8aBy4HaVS6tXDWTsU7f-ApLD8gDtb1uk,252
 aip_agents/examples/hello_world_pii_logger.py,sha256=pm9LK-doZwQL-VdJYFHziuvwH562c8wwAwmKZeAWQS0,584
 aip_agents/examples/hello_world_pii_logger.pyi,sha256=5gOVrvhQV2DxIwr7ocL1-oTUXsO8XSyl5WN70c7rl_w,134
-aip_agents/examples/hello_world_sentry.py,sha256=V-q6r9Nw76XosFGxIAxVtbpp_WmncgqU0PoBwMNBXXY,3958
+aip_agents/examples/hello_world_sentry.py,sha256=UI9bkfoui4SjhHWSllJGUdaup3kYzGtoomZkY1zhcXg,4005
 aip_agents/examples/hello_world_sentry.pyi,sha256=k0wFj46QqXEjBU0CEERmiEf2bovVFkupzuzQzeD6h00,671
 aip_agents/examples/hello_world_step_limits.py,sha256=hRV9XERlq2qW_yZ4kHAe1hTgukrSZjThIrsY9NuTdJg,9809
 aip_agents/examples/hello_world_step_limits.pyi,sha256=V9KP6r5OEVq2lNUfnqMeCGH1nsNewDsRL1Uo9up8xis,1060
@@ -348,10 +348,10 @@ aip_agents/schema/step_limit.py,sha256=8hqHSxHBWro8qvNR0pMxROpFSzlLqcyFO4veS_WDP
 aip_agents/schema/step_limit.pyi,sha256=UvLDMTy8BI7h1Jx5gpbpw1jrJ9L5vK8cmQkvQdlD3bs,2318
 aip_agents/schema/storage.py,sha256=Tl0RFT32GWdsc5y8bTvpWMOU8hmQxXIlrMub3qdwx8Y,1290
 aip_agents/schema/storage.pyi,sha256=exaZAS49PYSuhYSPYukIRCRHIGRyCpBGucrdpnhV4zE,557
-aip_agents/sentry/__init__.py,sha256=S1XFjmAnNsqnI_Jk_ozNqDodkqWgzZ8xZPTXS2zqXzI,252
+aip_agents/sentry/__init__.py,sha256=l3nI-3pjBNNmcOZ7xPeIis1n_wkPpvnk2aHxQYWsflU,261
 aip_agents/sentry/__init__.pyi,sha256=OGxzQzEvbnqf02zXdBJUrHeKfjfBgvnOL7p-0gNvP8k,103
-aip_agents/sentry/sentry.py,sha256=LlahQ2bkjL9FSFH0RoCdMDLhyXEUAj3zHkK_xxMQIKo,4501
-aip_agents/sentry/sentry.pyi,sha256=G9YgWGIqHskkfj9aXN-Y6RLe3tvDvYi_RSkW1Y_MFzE,1436
+aip_agents/sentry/sentry.py,sha256=DgYaIph-VQp0b36sUFvBqxe9lmbBZv1i1edg0Tx5nbE,4595
+aip_agents/sentry/sentry.pyi,sha256=fTFb71FfeByBUIACjkp8qaHsWe6C52Y4tPTfizAPVv0,1432
 aip_agents/storage/__init__.py,sha256=cN4L2whui-DOm81tsYV88Wx5g5-cUjeLVyp55RtbJJU,1219
 aip_agents/storage/__init__.pyi,sha256=wn8VuS7x4WSzKuV01WrjPkZfnh3GylNum9FlPiaSdsA,901
 aip_agents/storage/base.py,sha256=dijzGJJRHPEneV-6QRC_xm0CzgYuIyhmnWloJC8oIx0,2413
@@ -370,12 +370,12 @@ aip_agents/storage/providers/memory.py,sha256=81E9yT_oRkH7tMVr5azZv1oXIaeTzTAtTu
 aip_agents/storage/providers/memory.pyi,sha256=r0meeCsjKyE9FHJqCysfQ5ZH_FWRRv2SWg-NOHCUD-g,2109
 aip_agents/storage/providers/object_storage.py,sha256=Q268Sn8Y09gS-ilP6fe4CR0YIOvdbunh3V6SmuQsAVs,6413
 aip_agents/storage/providers/object_storage.pyi,sha256=nBIKJjUAWkIKhYhBFmFcypjoOieIYOghy55f62x7AX8,2878
-aip_agents/tools/__init__.py,sha256=9nQiB63jqn0G45fN3rF7wXmYOn2TrWASGbHBPr6LTd4,1199
-aip_agents/tools/__init__.pyi,sha256=ViizRq0Pv0cFxX90X6WoXZPcWrZ4-dJzbOnw5UgWUmc,619
-aip_agents/tools/bosa_tools.py,sha256=uhRImaIACt_Ol9nraUGr0ddT8e35c8doVzwlJV6kGeA,3411
-aip_agents/tools/bosa_tools.pyi,sha256=GpWQhkytk4XS_rKWGBiS70y5mXC8b-1GGCkN1BaE97s,1128
-aip_agents/tools/constants.py,sha256=pVmUJx8WN1gYtDT52B4FsetnaYZZWozKQQ7wW18xIHo,5274
-aip_agents/tools/constants.pyi,sha256=QucwMEKTXywF72m8ofImoswbj6zA-BsfP0tRaIy7A6Y,3393
+aip_agents/tools/__init__.py,sha256=HWj2nsjMBadA6aJdPlBQBSBxbvDAYmMKe3PJeNyDRbA,1935
+aip_agents/tools/__init__.pyi,sha256=w1gRWL5iRdLtuBNXBhmD87uzfvIRrXwq3uZ1meku8js,888
+aip_agents/tools/constants.py,sha256=S8-ctDo4FXp5Si8dFCJ2FORPPS1SKD2OQT5II3j1yak,5731
+aip_agents/tools/constants.pyi,sha256=kFY8dKgRqHKGvPqG3QUyuEc8C5yRaDj7DYQDH88K2T0,3552
+aip_agents/tools/gl_connector_tools.py,sha256=yXLuGTTAUxCYpOG808pKcHEZIntNI_x-JUq3OqzxexI,3971
+aip_agents/tools/gl_connector_tools.pyi,sha256=2ATn_MW_FRg5Uv7dLI_ToBOtlgTSfj0zgDQpN1N-cJs,1366
 aip_agents/tools/memory_search_tool.py,sha256=gqTTb_Fao_Hl-SavfaFsqPDhnFQUjzIQUkzizSD2L0A,653
 aip_agents/tools/memory_search_tool.pyi,sha256=BCVFEEgH3pETnI9b6vRlMm2_PnnIeBe_vuMlL9y3LpU,453
 aip_agents/tools/time_tool.py,sha256=NPjz73hy1SNc3okWhDXdR45q84vmRUerDGDk_E-XyZk,3732
@@ -428,10 +428,10 @@ aip_agents/tools/document_loader/pdf_reader_tool.py,sha256=36U_r7E0n_nLl4xUXC4nD
 aip_agents/tools/document_loader/pdf_reader_tool.pyi,sha256=ZKr5E3ePTJWHdLfM3_7Ji9NGDpL29uKLFhLl-smZQqQ,494
 aip_agents/tools/document_loader/pdf_splitter.py,sha256=-QyrlnN4AXDqY_dxeUzxcgCVJJiD1vYUYR7swfhM_RQ,5752
 aip_agents/tools/document_loader/pdf_splitter.pyi,sha256=3IiRDQWDz8QR5LH_sni9O-N2qJFheFjKOQMAhiWxB7E,716
-aip_agents/tools/gl_connector/__init__.py,sha256=tpQ0vF7gMiyO32jTBndOAVor5MRDNff7yh_SC7Frv_U,136
+aip_agents/tools/gl_connector/__init__.py,sha256=f8F4mdBFj0ulxewCQwG5qN2SDzlgI2jA0Kfj31A5iD0,137
 aip_agents/tools/gl_connector/__init__.pyi,sha256=96wtNkB3VUSI66aRlYxVrzMiPtqOYviRMKviRgX3_fc,113
-aip_agents/tools/gl_connector/tool.py,sha256=FaS8B6lJI4RuB5NoirqezIBQhsVb4ymUBvItJXtdWMc,11999
-aip_agents/tools/gl_connector/tool.pyi,sha256=u6GQCwxqFLVhZVYeTek6ExEvrhPTF7z1QCHcRtcgFqU,2746
+aip_agents/tools/gl_connector/tool.py,sha256=EmfAYU5ZEtG93osWPWd4ElfXIhBe7mqz0yIH6Ntc9sE,13343
+aip_agents/tools/gl_connector/tool.pyi,sha256=a5l0MHSOe_iWDvjMRzYtcbMdX0bFlK1m7Hl52HQ__iQ,2770
 aip_agents/tools/memory_search/__init__.py,sha256=YSsObYlHjdZEbJj4MVYy3Ht8JPlo42YhjnkI-yFNWV0,608
 aip_agents/tools/memory_search/__init__.pyi,sha256=NG0g94OoC_xw66yIqiPViqTnpj01QdnRsVBGzkSxJFI,554
 aip_agents/tools/memory_search/base.py,sha256=M4Vq5CnXge1rhVkESfVCAjyWEc6Ijmh8-6oAMkcZkjY,7333
@@ -540,7 +540,7 @@ aip_agents/utils/pii/pii_helper.py,sha256=g0yRzakfA2AA6vjUNLWHqFlcxyLql6MXQ90NN3
 aip_agents/utils/pii/pii_helper.pyi,sha256=dulZs150ikbAL3Bw2YLcz3_g4DsGmL3lciwf8mKxEjI,2939
 aip_agents/utils/pii/uuid_deanonymizer_mapping.py,sha256=Gks8l8t0cuS9pzoQnrpiK1CaLmWYksjOnTeiHh3_7EE,7348
 aip_agents/utils/pii/uuid_deanonymizer_mapping.pyi,sha256=gnWfD1rWZh_tloJjgKiZ6f6iNUuBaHpKqCSiP0d-9bs,3084
-aip_agents_binary-0.5.20.dist-info/METADATA,sha256=mfxqDEti6yRl2Rh5gjxpO278NjMj1UfGq41na3pT_jE,22207
-aip_agents_binary-0.5.20.dist-info/WHEEL,sha256=PaP4PvkDyiSc4C6Dhw6ccQmfxsWFrSv-lJQjBshu0hw,105
-aip_agents_binary-0.5.20.dist-info/top_level.txt,sha256=PEz8vcwC1bH4UrkhF0LkIYCNfXGWZUHdSklbvkBe25E,11
-aip_agents_binary-0.5.20.dist-info/RECORD,,
+aip_agents_binary-0.5.22.dist-info/METADATA,sha256=CocpyU4hmWP-sT9ti3uGtzFDcULe2Vr2sJVH-Ae2ftM,22214
+aip_agents_binary-0.5.22.dist-info/WHEEL,sha256=PaP4PvkDyiSc4C6Dhw6ccQmfxsWFrSv-lJQjBshu0hw,105
+aip_agents_binary-0.5.22.dist-info/top_level.txt,sha256=PEz8vcwC1bH4UrkhF0LkIYCNfXGWZUHdSklbvkBe25E,11
+aip_agents_binary-0.5.22.dist-info/RECORD,,

aip_agents/examples/hello_world_langgraph_bosa_twitter.pyi

@@ -1,5 +0,0 @@
-from aip_agents.agent import LangGraphAgent as LangGraphAgent
-from aip_agents.tools import BOSA_AUTOMATED_TOOLS as BOSA_AUTOMATED_TOOLS
-
-async def langgraph_bosa_example() -> None:
-    """Demonstrates the LangGraphAgent's arun method."""

aip_agents/tools/bosa_tools.py

@@ -1,105 +0,0 @@
-"""Auto-generated tools from BOSA connector.
-
-Authors:
-    Saul Sayers (saul.sayers@gdplabs.id)
-"""
-
-from bosa_connectors import BosaConnector, BOSAConnectorToolGenerator
-from langchain_core.tools import BaseTool
-
-from aip_agents.tools.constants import BOSA_API_BASE_URL, BOSA_API_KEY, BOSA_FETCH_MAX_RETRIES, ToolType
-from aip_agents.utils.logger import get_logger
-
-logger = get_logger(__name__)
-
-
-def get_bosa_modules_with_retry() -> list[str]:
-    """Try to get available modules with retries.
-
-    Returns:
-        List of available modules.
-    """
-    if not BOSA_API_BASE_URL or not BOSA_API_KEY:
-        logger.warning("BOSA credentials missing (base_url or api_key); returning empty modules list")
-        return []
-
-    connector = BosaConnector(api_base_url=BOSA_API_BASE_URL, api_key=BOSA_API_KEY)
-    modules = []
-    for attempt in range(BOSA_FETCH_MAX_RETRIES):
-        try:
-            modules = list(connector.get_available_modules())
-            if modules:
-                return modules
-            logger.warning(
-                f"Failed to get BOSA available modules, retrying... (attempt {attempt + 1} / {BOSA_FETCH_MAX_RETRIES})"
-            )
-        except Exception as e:
-            logger.exception(
-                f"Exception when getting BOSA available modules (attempt {attempt + 1} / {BOSA_FETCH_MAX_RETRIES}): {e}"
-            )
-    logger.error("Failed to get BOSA available modules after maximum retries")
-    return modules
-
-
-class LazyBosaToolsDict(dict):
-    """Lazy dictionary for BOSA tools."""
-
-    def __missing__(self, app):
-        """When a key is missing, create the tools and store them in the dictionary.
-
-        Args:
-            app: Name of the BOSA connector.
-
-        Returns:
-            List of tools generated by BOSAConnectorToolGenerator.
-        """
-        if app not in get_bosa_modules():
-            return []
-        tools = []
-        for attempt in range(BOSA_FETCH_MAX_RETRIES):
-            try:
-                tools = BOSAConnectorToolGenerator(
-                    api_base_url=BOSA_API_BASE_URL,
-                    api_key=BOSA_API_KEY,
-                    app_name=app,
-                ).generate_tools(tool_type=ToolType.LANGCHAIN)
-                if tools:
-                    self[app] = tools
-                    return tools
-                logger.warning(
-                    f"Failed to create BOSA tools, retrying... (attempt {attempt + 1} / {BOSA_FETCH_MAX_RETRIES})"
-                )
-            except Exception as e:
-                logger.exception(
-                    f"Exception when creating BOSA tools for app '{app}' "
-                    f"(attempt {attempt + 1} / {BOSA_FETCH_MAX_RETRIES}): {e}"
-                )
-        logger.error("Failed to create BOSA tools after maximum retries")
-        return tools
-
-
-# Supported modules (dynamic)
-def get_bosa_modules() -> list[str]:
-    """Lazily fetch and cache BOSA modules.
-
-    This is for backwards compatibility with the old BOSA modules.
-
-    Returns:
-        List of BOSA modules.
-    """
-    if not hasattr(get_bosa_modules, "_cache"):
-        get_bosa_modules._cache = get_bosa_modules_with_retry()
-    return get_bosa_modules._cache
-
-
-# FOR BACKWARDS COMPATIBILITY
-BOSA_MODULES = [
-    "github",
-    "twitter",
-    "google",
-    "google_drive",
-    "google_mail",
-    "google_docs",
-]
-
-BOSA_AUTOMATED_TOOLS: dict[str, list[BaseTool]] = LazyBosaToolsDict()

aip_agents/tools/bosa_tools.pyi

@@ -1,37 +0,0 @@
-from _typeshed import Incomplete
-from aip_agents.tools.constants import BOSA_API_BASE_URL as BOSA_API_BASE_URL, BOSA_API_KEY as BOSA_API_KEY, BOSA_FETCH_MAX_RETRIES as BOSA_FETCH_MAX_RETRIES, ToolType as ToolType
-from aip_agents.utils.logger import get_logger as get_logger
-from langchain_core.tools import BaseTool as BaseTool
-
-logger: Incomplete
-
-def get_bosa_modules_with_retry() -> list[str]:
-    """Try to get available modules with retries.
-
-    Returns:
-        List of available modules.
-    """
-
-class LazyBosaToolsDict(dict):
-    """Lazy dictionary for BOSA tools."""
-    def __missing__(self, app):
-        """When a key is missing, create the tools and store them in the dictionary.
-
-        Args:
-            app: Name of the BOSA connector.
-
-        Returns:
-            List of tools generated by BOSAConnectorToolGenerator.
-        """
-
-def get_bosa_modules() -> list[str]:
-    """Lazily fetch and cache BOSA modules.
-
-    This is for backwards compatibility with the old BOSA modules.
-
-    Returns:
-        List of BOSA modules.
-    """
-
-BOSA_MODULES: Incomplete
-BOSA_AUTOMATED_TOOLS: dict[str, list[BaseTool]]