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

aip_agents/tools/__init__.py

@@ -1,6 +1,33 @@
 """Initialize Tools Module for AIP Agents."""
 
+from importlib import import_module
+
 from aip_agents.tools.bosa_tools import 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
+
+__all__ = ["BOSA_AUTOMATED_TOOLS", "GLConnectorTool", "GoogleSerperTool", "TimeTool"]
+
+
+def _register_optional(module_path: str, export_name: str) -> None:
+    """Try to import optional tool module and expose it in __all__.
+
+    Args:
+        module_path: The module path to import.
+        export_name: The name to export in __all__.
+    """
+    try:
+        module = import_module(module_path)
+    except ImportError:
+        return
+
+    globals()[export_name] = getattr(module, export_name)
+    __all__.append(export_name)
+
 
-__all__ = ["BOSA_AUTOMATED_TOOLS", "GLConnectorTool"]
+_register_optional("aip_agents.tools.browser_use", "BrowserUseTool")
+_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")

aip_agents/tools/__init__.pyi

@@ -1,4 +1,13 @@
 from aip_agents.tools.bosa_tools import BOSA_AUTOMATED_TOOLS as BOSA_AUTOMATED_TOOLS
 from aip_agents.tools.gl_connector import GLConnectorTool as GLConnectorTool
+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']
+__all__ = ['BOSA_AUTOMATED_TOOLS', 'GLConnectorTool', 'GoogleSerperTool', 'TimeTool', 'BrowserUseTool', 'E2BCodeSandboxTool', 'DocxReaderTool', 'ExcelReaderTool', 'PDFReaderTool']
+
+# Names in __all__ with no definition:
+#   BrowserUseTool
+#   DocxReaderTool
+#   E2BCodeSandboxTool
+#   ExcelReaderTool
+#   PDFReaderTool

aip_agents/tools/time_tool.py

@@ -0,0 +1,117 @@
+"""Tool to get the current time.
+
+Authors:
+    Saul Sayers (saul.sayers@gdplabs.id)
+"""
+
+import re
+from datetime import datetime, timedelta, timezone, tzinfo
+
+from dateutil import tz
+from langchain_core.tools import BaseTool
+from pydantic import BaseModel, Field
+
+FORMAT_STRING = "%m/%d/%y %H:%M:%S"
+DEFAULT_TIMEZONE = "UTC+7"
+
+
+class TimeToolInput(BaseModel):
+    """Input schema for the TimeTool."""
+
+    datetime_format: str = Field(
+        default=FORMAT_STRING,
+        description="""
+        Optional datetime format string. Default: '%m/%d/%y %H:%M:%S'
+
+        Common format codes:
+        %Y: Year with century (2024)
+        %m: Month as number (01-12)
+        %d: Day of month (01-31)
+        %A: Full weekday name (Wednesday)
+        %a: Short weekday name (Wed)
+        %H: Hour (00-23)
+        %M: Minute (00-59)
+        %S: Second (00-59)
+        %Z: Timezone name
+        %j: Day of year (001-366)
+        %W: Week number (00-53, Monday first)
+        %U: Week number (00-53, Sunday first)
+        %c: Locale's date and time
+        %x: Locale's date
+        %X: Locale's time
+        """,
+    )
+    timezone: str | None = Field(
+        default=DEFAULT_TIMEZONE,
+        description="""
+        Optional timezone identifier. Supports IANA names (e.g., 'Asia/Jakarta')
+        or offsets (e.g., 'UTC+7', 'UTC-04:30'). Default: 'UTC+7' (Asia/Jakarta).
+        Highly recommended to be filled when getting the current time to ensure
+        the time is in the correct timezone.
+        """,
+    )
+
+
+def _parse_timezone(timezone_value: str | None) -> tzinfo | None:
+    """Return a tzinfo instance for a given timezone string.
+
+    Args:
+        timezone_value: Timezone string (e.g., "UTC+7", "UTC-5:30") or None.
+
+    Returns:
+        tzinfo instance or None if invalid/None input.
+    """
+    if timezone_value is None:
+        return None
+
+    tz_string = timezone_value.strip()
+    if not tz_string:
+        return None
+
+    offset_match = re.fullmatch(r"UTC([+-])(\d{1,2})(?::?(\d{2}))?$", tz_string.upper())
+    if offset_match:
+        sign, hours_str, minutes_str = offset_match.groups()
+        hours = int(hours_str)
+        minutes = int(minutes_str) if minutes_str else 0
+        MAX_HOURS_OFFSET = 12
+        MINUTES_OFFSETS = [0, 30, 45]
+        if hours > MAX_HOURS_OFFSET or minutes not in MINUTES_OFFSETS:
+            raise ValueError(f"Invalid timezone offset: {timezone_value}")
+        delta = timedelta(hours=hours, minutes=minutes)
+        if sign == "-":
+            delta = -delta
+        return timezone(delta)
+
+    tzinfo = tz.gettz(tz_string)
+    if tzinfo is not None:
+        return tzinfo
+
+    raise ValueError(f"Unknown timezone: {timezone_value}")
+
+
+class TimeTool(BaseTool):
+    """Tool to get the current time."""
+
+    name: str = "time_tool"
+    description: str = """
+    Useful for getting the current time in a specified format and timezone.
+    Default format: '%m/%d/%y %H:%M:%S' (e.g., '05/15/24 17:30:00')
+
+    Supports timezone specification to get the current time in any timezone.
+    It is highly recommended to specify a timezone to ensure accurate results.
+    """
+    args_schema: type[BaseModel] = TimeToolInput
+
+    def _run(self, datetime_format: str = FORMAT_STRING, timezone: str | None = DEFAULT_TIMEZONE) -> str:
+        """Get current time formatted according to the specified format and timezone.
+
+        Args:
+            datetime_format: Format string for datetime (default: ISO format).
+            timezone: Timezone string (default: UTC).
+
+        Returns:
+            Formatted datetime string.
+        """
+        tzinfo = _parse_timezone(timezone)
+        current_time = datetime.now(tz=tzinfo)
+        return current_time.strftime(datetime_format)

aip_agents/tools/time_tool.pyi

@@ -0,0 +1,16 @@
+from langchain_core.tools import BaseTool
+from pydantic import BaseModel
+
+FORMAT_STRING: str
+DEFAULT_TIMEZONE: str
+
+class TimeToolInput(BaseModel):
+    """Input schema for the TimeTool."""
+    datetime_format: str
+    timezone: str | None
+
+class TimeTool(BaseTool):
+    """Tool to get the current time."""
+    name: str
+    description: str
+    args_schema: type[BaseModel]

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aip-agents-binary
-Version: 0.5.19
+Version: 0.5.20
 Summary: A library for managing agents in Gen AI applications.
 Author-email: Raymond Christopher <raymond.christopher@gdplabs.id>
 Requires-Python: <3.13,>=3.11

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

@@ -370,14 +370,16 @@ 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=1axwxcs8h0hFcPIeslib-9N0Kh0bNn_OzpX6Ac8YlmY,221
-aip_agents/tools/__init__.pyi,sha256=11EgOX_y_nTPJCTwgO--owBm5cwo2GXMNKNot75YuHY,217
+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/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
+aip_agents/tools/time_tool.pyi,sha256=sF8INR8-VRmETquuQ6BIY0geEGXhMLzbcddpnMb0H7k,374
 aip_agents/tools/tool_config_injector.py,sha256=rk8uqwz-LUpZ_d0cUK0ywxnkzINfTPMN3GMxcKPLVjE,10559
 aip_agents/tools/tool_config_injector.pyi,sha256=TzxFCQ9KkTT3CSTJfU7lgsW5RcbZ9RqXR8Btyny_dTs,1055
 aip_agents/tools/browser_use/__init__.py,sha256=_ZYoSads6DRHK9odnPfvEBRDAncIkkFUo7Ach5kPrlI,2118
@@ -538,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.19.dist-info/METADATA,sha256=3SORaqjs5lh60tl5arWKz10eVrgzUE57LfNKasoEB9g,22207
-aip_agents_binary-0.5.19.dist-info/WHEEL,sha256=PaP4PvkDyiSc4C6Dhw6ccQmfxsWFrSv-lJQjBshu0hw,105
-aip_agents_binary-0.5.19.dist-info/top_level.txt,sha256=PEz8vcwC1bH4UrkhF0LkIYCNfXGWZUHdSklbvkBe25E,11
-aip_agents_binary-0.5.19.dist-info/RECORD,,
+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,,