gllm-core-binary 0.4.4__py3-none-macosx_13_0_arm64.whl

gllm_core/utils/retry.pyi

@@ -0,0 +1,41 @@
+from _typeshed import Incomplete
+from gllm_core.utils import LoggerManager as LoggerManager
+from gllm_core.utils.concurrency import syncify as syncify
+from pydantic import BaseModel
+from typing import Any, Callable, TypeVar, overload
+
+logger: Incomplete
+T = TypeVar('T')
+BASE_EXPONENTIAL_BACKOFF: float
+
+class RetryConfig(BaseModel):
+    """Configuration for retry behavior.
+
+    Attributes:
+        max_retries (int): Maximum number of retry attempts.
+        base_delay (float): Base delay in seconds between retries.
+        max_delay (float): Maximum delay in seconds between retries.
+        jitter (bool): Whether to add random jitter to delays.
+        timeout (float | None): Overall timeout in seconds for the entire operation. If None, timeout is disabled.
+        retry_on_exceptions (tuple[type[Exception], ...]): Tuple of exception types to retry on.
+    """
+    max_retries: int
+    base_delay: float
+    max_delay: float
+    jitter: bool
+    timeout: float | None
+    retry_on_exceptions: tuple[type[Exception], ...]
+    def validate_delay_constraints(self) -> RetryConfig:
+        """Validates that max_delay is greater than or equal to base_delay.
+
+        Returns:
+            RetryConfig: The validated configuration.
+
+        Raises:
+            ValueError: If max_delay is less than base_delay.
+        """
+
+@overload
+async def retry(func: Callable[..., Any], *args: Any, retry_config: RetryConfig | None = None, **kwargs: Any) -> T: ...
+@overload
+def retry(config: RetryConfig | None = None) -> Callable[[Callable[..., Any]], Callable[..., Any]]: ...

gllm_core/utils/similarity.py

@@ -0,0 +1,29 @@
+"""Utility function to calculate cosine similarity between a vector and a matrix.
+
+Authors:
+    Dimitrij Ray (dimitrij.ray@gdplabs.id)
+
+References:
+    NONE
+"""
+
+import numpy as np
+from scipy.spatial.distance import cdist
+
+
+def cosine(vector: list[float], matrix: list[list[float]]) -> list[float]:
+    """Calculate cosine similarities between a vector and a matrix of vectors.
+
+    Args:
+        vector (list[float]): The input vector to compare against.
+        matrix (list[list[float]]): The matrix of vectors to compare with.
+
+    Returns:
+        list[float]: The list of cosine similarities between the vector and each row of the matrix.
+    """
+    vector = np.array(vector).reshape(1, -1)
+    matrix = np.array(matrix)
+
+    similarities = 1 - cdist(matrix, vector, metric="cosine")
+
+    return similarities.flatten().tolist()

gllm_core/utils/similarity.pyi

@@ -0,0 +1,10 @@
+def cosine(vector: list[float], matrix: list[list[float]]) -> list[float]:
+    """Calculate cosine similarities between a vector and a matrix of vectors.
+
+    Args:
+        vector (list[float]): The input vector to compare against.
+        matrix (list[list[float]]): The matrix of vectors to compare with.
+
+    Returns:
+        list[float]: The list of cosine similarities between the vector and each row of the matrix.
+    """

gllm_core/utils/validation.py

@@ -0,0 +1,26 @@
+"""Defines validation utilities.
+
+Authors:
+    Henry Wicaksono (henry.wicaksono@gdplabs.id)
+
+References:
+    NONE
+"""
+
+from enum import StrEnum
+
+
+def validate_string_enum(enum_type: type[StrEnum], value: str) -> None:
+    """Validates that the provided value is a valid string enum value.
+
+    Args:
+        enum_type (type[StrEnum]): The type of the string enum.
+        value (str): The value to validate.
+
+    Raises:
+        ValueError: If the provided value is not a valid string enum value.
+    """
+    valid_values = [item.value for item in enum_type]
+    if value not in valid_values:
+        error_message = f"Invalid {enum_type.__name__}: {value!r}. Valid values: {valid_values}."
+        raise ValueError(error_message) from None

gllm_core/utils/validation.pyi

@@ -0,0 +1,12 @@
+from enum import StrEnum
+
+def validate_string_enum(enum_type: type[StrEnum], value: str) -> None:
+    """Validates that the provided value is a valid string enum value.
+
+    Args:
+        enum_type (type[StrEnum]): The type of the string enum.
+        value (str): The value to validate.
+
+    Raises:
+        ValueError: If the provided value is not a valid string enum value.
+    """

gllm_core_binary-0.4.4.dist-info/METADATA

@@ -0,0 +1,177 @@
+Metadata-Version: 2.4
+Name: gllm-core-binary
+Version: 0.4.4
+Summary: A library containing core components for Gen AI applications.
+Author-email: Dimitrij Ray <dimitrij.ray@gdplabs.id>, Henry Wicaksono <henry.wicaksono@gdplabs.id>, Resti Febriana <resti.febriana@gdplabs.id>
+Requires-Python: <3.14,>=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: anyio<5.0.0,>=4.10.0
+Requires-Dist: deprecation<3.0.0,>=2.1.0
+Requires-Dist: google<4.0.0,>=3.0.0
+Requires-Dist: google-auth<3.0.0,>=2.38.0
+Requires-Dist: gspread<7.0.0,>=6.1.4
+Requires-Dist: numpy<2.0.0,>=1.26; python_version < "3.12"
+Requires-Dist: numpy<3.0.0,>=1.26; python_version >= "3.12" and python_version < "3.13"
+Requires-Dist: numpy<3.0.0,>=2.2; python_version >= "3.13"
+Requires-Dist: pydantic<3.0.0,>=2.11.4
+Requires-Dist: python-json-logger<4.0.0,>=3.3.0
+Requires-Dist: rich<15.0.0,>=14.1.0
+Requires-Dist: scipy<2.0.0,>=1.15.1
+Provides-Extra: dev
+Requires-Dist: coverage<8.0.0,>=7.4.4; extra == "dev"
+Requires-Dist: mypy<2.0.0,>=1.15.0; extra == "dev"
+Requires-Dist: pre-commit<4.0.0,>=3.7.0; extra == "dev"
+Requires-Dist: pytest<9.0.0,>=8.1.1; extra == "dev"
+Requires-Dist: pytest-asyncio<1.0.0,>=0.23.6; extra == "dev"
+Requires-Dist: pytest-cov<6.0.0,>=5.0.0; extra == "dev"
+Requires-Dist: ruff<1.0.0,>=0.6.7; extra == "dev"
+Provides-Extra: langchain
+Requires-Dist: langchain-core<1.0.0,>=0.3.0; extra == "langchain"
+Provides-Extra: google-adk
+Requires-Dist: google-adk<2.0.0,>=1.0.0; extra == "google-adk"
+Requires-Dist: starlette<1.0.0,>=0.49.0; extra == "google-adk"
+
+# GLLM Core
+
+## Description
+A core library providing foundational components and utilities for Generative AI applications.
+
+---
+
+## Installation
+
+### Prerequisites
+
+Mandatory:
+1. Python 3.11+ — [Install here](https://www.python.org/downloads/)
+2. pip — [Install here](https://pip.pypa.io/en/stable/installation/)
+3. uv — [Install here](https://docs.astral.sh/uv/getting-started/installation/)
+
+Extras (required only for Artifact Registry installations):
+1. gcloud CLI (for authentication) — [Install here](https://cloud.google.com/sdk/docs/install), then log in using:
+   ```bash
+   gcloud auth login
+   ```
+
+---
+
+### Option 1: Install from Artifact Registry
+
+This option requires authentication via the `gcloud` CLI.
+
+```bash
+uv pip install \
+  --extra-index-url "https://oauth2accesstoken:$(gcloud auth print-access-token)@glsdk.gdplabs.id/gen-ai-internal/simple/" \
+  gllm-inference
+```
+
+---
+
+### Option 2: Install from PyPI
+
+This option requires no authentication.
+However, it installs the **binary wheel** version of the package, which is fully usable but **does not include source code**.
+
+```bash
+uv pip install gllm-core-binary
+```
+
+---
+
+## Local Development Setup
+
+### Prerequisites
+
+1. Python 3.11+ — [Install here](https://www.python.org/downloads/)
+2. pip — [Install here](https://pip.pypa.io/en/stable/installation/)
+3. uv — [Install here](https://docs.astral.sh/uv/getting-started/installation/)
+4. gcloud CLI — [Install here](https://cloud.google.com/sdk/docs/install), then log in using:
+
+   ```bash
+   gcloud auth login
+   ```
+5. Git — [Install here](https://git-scm.com/downloads)
+6. Access to the [GDP Labs SDK GitHub repository](https://github.com/GDP-ADMIN/gl-sdk)
+
+---
+
+### 1. Clone Repository
+
+```bash
+git clone git@github.com:GDP-ADMIN/gl-sdk.git
+cd gl-sdk/libs/gllm-core
+```
+
+---
+
+### 2. Setup Authentication
+
+Set the following environment variables to authenticate with internal package indexes:
+
+```bash
+export UV_INDEX_GEN_AI_INTERNAL_USERNAME=oauth2accesstoken
+export UV_INDEX_GEN_AI_INTERNAL_PASSWORD="$(gcloud auth print-access-token)"
+export UV_INDEX_GEN_AI_USERNAME=oauth2accesstoken
+export UV_INDEX_GEN_AI_PASSWORD="$(gcloud auth print-access-token)"
+```
+
+---
+
+### 3. Quick Setup
+
+Run:
+
+```bash
+make setup
+```
+
+---
+
+### 4. Activate Virtual Environment
+
+```bash
+source .venv/bin/activate
+```
+
+---
+
+## Local Development Utilities
+
+The following Makefile commands are available for quick operations:
+
+### Install uv
+
+```bash
+make install-uv
+```
+
+### Install Pre-Commit
+
+```bash
+make install-pre-commit
+```
+
+### Install Dependencies
+
+```bash
+make install
+```
+
+### Update Dependencies
+
+```bash
+make update
+```
+
+### Run Tests
+
+```bash
+make test
+```
+
+---
+
+## Contributing
+
+Please refer to the [Python Style Guide](https://docs.google.com/document/d/1uRggCrHnVfDPBnG641FyQBwUwLoFw0kTzNqRm92vUwM/edit?usp=sharing)
+for information about code style, documentation standards, and SCA requirements.

gllm_core_binary-0.4.4.dist-info/RECORD

@@ -0,0 +1,78 @@
+gllm_core/__init__.py,sha256=apA-bxlbdiIlLNX94HW4pLrnML2i1Og8_Brft_MhKBg,53
+gllm_core/__init__.pyi,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+gllm_core/constants.py,sha256=QQZ4WQcd3pa5mBgFW7kiQTXe9YeOtbCRuSRajboK-6g,1057
+gllm_core/constants.pyi,sha256=XSI68jXkzB4kPyNKdtjwtyWbLkoxrbGubJflFTnK0QM,868
+gllm_core/adapters/__init__.py,sha256=rCJBJDdUYfkuKt4acyRiqdHVdeGhYf4KXy1j8D3eR4Y,175
+gllm_core/adapters/__init__.pyi,sha256=Qu6wKgusdKduuu9PSbYj31XTDscU7EHXlL-EgEpo4Oc,184
+gllm_core/adapters/tool/__init__.py,sha256=jSIpzSKhZJr1Q7Nbng59qn8GwJiaEhGKxB6YyACas2Q,236
+gllm_core/adapters/tool/__init__.pyi,sha256=0x7T-6LUze1tGxuRT0YGLQb5aOFjBcobOIT_sD8SpbA,240
+gllm_core/adapters/tool/google_adk.py,sha256=DwQ6cT4SSMdfVeHBPLmWB-gvKM0uNPGCzH3yDGZ7q3Q,3103
+gllm_core/adapters/tool/google_adk.pyi,sha256=-A7njFYtuLd4jwdBpIeqWhAZz8sWlbKol0CE3csdzSw,930
+gllm_core/adapters/tool/langchain.py,sha256=TbJJKsN9NTXTZD5Ihukp_5wmUWOABMuaNRS1__wfnZY,3695
+gllm_core/adapters/tool/langchain.pyi,sha256=jau-THBLln7EFmrV3mZ-cXNJRbndewYU7zNJKSB-1kQ,824
+gllm_core/event/__init__.py,sha256=pe0LPlFrg2HJNOA9K__avZHicwkAKoAEJJaYZq-MoIA,237
+gllm_core/event/__init__.pyi,sha256=b5u52ZXzKNFLTvAnZ1Xzcvmby4lr8i7WyHRzCJ0fmq0,173
+gllm_core/event/event_emitter.py,sha256=fu2cRiQU7roHFFBrcfnks2cJx8sGBc7y7GSoMm4u1YM,8447
+gllm_core/event/event_emitter.pyi,sha256=Eu3g41YdJfEQw66M6lZwGNBWVPIxwuL2rROvt4NOBUw,7142
+gllm_core/event/messenger.py,sha256=KYYVZmFG4s9wdgfYwmdZXxsyaAMrLTCIgJuiRSWfcds,5531
+gllm_core/event/messenger.pyi,sha256=ZWzzlW-lgdPVqGD8N9F-jV6XeMbGEH0Tkd2vnG0DExI,3124
+gllm_core/event/handler/__init__.py,sha256=JUJEr_eYj2Ps7S2-RdH-4aSfRYNfgBU_H0H-_GeTx9w,399
+gllm_core/event/handler/__init__.pyi,sha256=dD1lc_iUaZq08Oh0gIEnAt1r_vsnY41Rqj1Bt_elK6M,372
+gllm_core/event/handler/console_event_handler.py,sha256=CUi2aa6J-AWg8w5pKM9nIACvmZ5YM59eHJxcbjcR7TE,1769
+gllm_core/event/handler/console_event_handler.pyi,sha256=x7ns-b3YMCvTu4tNQC_sjgkF9JgCXekyhe0JGvpMCKs,1462
+gllm_core/event/handler/event_handler.py,sha256=GaRHqw96ChESaFyQgAYLO3Rts6h8nvp-BC0IuWvqbJk,2966
+gllm_core/event/handler/event_handler.pyi,sha256=bUX0o-xeB3I9H_lsQC4qy3odGl0WY1ltkBTRGaN13ZI,2102
+gllm_core/event/handler/print_event_handler.py,sha256=o-M_PYoV8isZlnwtx4lvUWc0MhsqCF-8UcF4s6St_l4,4838
+gllm_core/event/handler/print_event_handler.pyi,sha256=y2C2jceTOArcp10i-WeZdpv7y4YWWCvSbKMNKAcZCIQ,1641
+gllm_core/event/handler/stream_event_handler.py,sha256=HWb0T7Dt8gIfbi-ely7bu8bx6_mrG_8p85Ms_qO2i70,3326
+gllm_core/event/handler/stream_event_handler.pyi,sha256=-bBO6_sGhJItpmKWaVvkOnFMEoawUy1Vl-qLoBVhkQ8,2846
+gllm_core/event/hook/__init__.py,sha256=HrWqtD0GnfT72iZ5u1K8BieR-dCzH5ZTb2CwP3QYmuY,199
+gllm_core/event/hook/__init__.pyi,sha256=6iIXWORbi3L_YVIKR10-KJMkv53sxyTlytesVj7sebw,146
+gllm_core/event/hook/event_hook.py,sha256=zhylqQgo8VuBrUq95VWqr6XjYShr0yPTU_5dsTbnQG4,703
+gllm_core/event/hook/event_hook.pyi,sha256=-bkwad1AhG0V9QXGoZPK-4z_2d6n7HRLZ7Q3wjPX2jI,582
+gllm_core/event/hook/json_stringify_event_hook.py,sha256=_nH5OCMliJHQLoHmiDUSRQ2L9Jn3iUdru8ojilqzPIU,817
+gllm_core/event/hook/json_stringify_event_hook.pyi,sha256=z_gfwR1fE6IKnQAbmG1MdDqHKeULhjBDG29BwH5iMkc,569
+gllm_core/schema/__init__.py,sha256=F2jP4dcDIXtA4Lj1y9vdBcG-615KoDGJ4QdMfsSKyno,328
+gllm_core/schema/__init__.pyi,sha256=bAZZ6JW7c9K_4h9u1NP-l7mhAW2XH842pMPxmIY36o0,304
+gllm_core/schema/chunk.py,sha256=xiLDk8BiFEmBYVkDvx3JGU7uQdsxsxigBddZessPZSY,4727
+gllm_core/schema/chunk.pyi,sha256=gZ_RcOTi3KLjfLo5ldeClc41nsbOFAMoq5KZ1d7O3fI,2312
+gllm_core/schema/component.py,sha256=uKFJFzMpnL0L4XfiFn012TD_oXke-i6_-SoAfuswBl0,21994
+gllm_core/schema/component.pyi,sha256=oHkvttAaxqFPdFMOb6B4y4stED2DnDeDywSF9PJT9bc,8959
+gllm_core/schema/event.py,sha256=I4XDnTLO_iV9-a_UyYaVHWiU9r-9DA3OrFAWFE2Dyco,1694
+gllm_core/schema/event.pyi,sha256=sJPkqod5KV3qJBMRUCjr6x1iTTooY-KHhBoZ_RpGy-E,1302
+gllm_core/schema/schema_generator.py,sha256=_Wp3OIrBVm_3QH-WoOv_mSZN0OMTmJ5a-2oUXyPaP7o,4979
+gllm_core/schema/schema_generator.pyi,sha256=Sj42NirNX-IIlfeGhDRbbfZ-IqTyfG12Y2nlHDEepGA,1410
+gllm_core/schema/tool.py,sha256=MPI937nlU51nprcWS45L7Xm4fuJt_gmuF7aSD4TOfIo,16226
+gllm_core/schema/tool.pyi,sha256=kfEgcBukXh8VTbocL_AefYku3HXaJcaSbf9148uwdBc,8650
+gllm_core/utils/__init__.py,sha256=_Ey2L5xUGdKwWYxDQjesd3VlqFr3sosAfcFAHVVd7u4,1168
+gllm_core/utils/__init__.pyi,sha256=30Zwha83t9kR5gbFZyk9bB01YggLmcgfQ1TYEqksrQA,1346
+gllm_core/utils/analyzer.py,sha256=Cm1_LVCwQjCfPQuaAZ7j-gD0UuzV3Hbtneu6rDp4GXU,8626
+gllm_core/utils/analyzer.pyi,sha256=62EjfyGb8v6xr144Nslxo4HG7XCMMbJCERNBM0w1CT0,4347
+gllm_core/utils/binary_handler_factory.py,sha256=GTUsYnbAVSi6V8taCsZrvo5MzRXtKvrEZM6FuGt1Nvw,2413
+gllm_core/utils/binary_handler_factory.pyi,sha256=kUx0tbFVDUIjrFZCIRhpMucQrz8X6F2T7HIpOCwyiR8,1677
+gllm_core/utils/chunk_metadata_merger.py,sha256=e5hz5Vm-wviVbnHYCX2Kr5I5OvbMtOcWhS3Rbp8HpSc,3994
+gllm_core/utils/chunk_metadata_merger.pyi,sha256=HTmvDXfKb64oOzyDmYOIx58pM-Dt7abbI1Tz_Nu0uHY,2276
+gllm_core/utils/concurrency.py,sha256=4H0Ci9RjCoqvg9P-EJb-_FGWv_Z1sPcC1vW94RQsG5A,6168
+gllm_core/utils/concurrency.pyi,sha256=JpZOMXx_RJQVT3Ua9t_gL03BfFAnq38maUouzfkrB3s,3865
+gllm_core/utils/event_formatter.py,sha256=nuWIZj_ZgeDiKh44eEI_3-jVgIXp2n3dOsn96dLVx7M,2168
+gllm_core/utils/event_formatter.pyi,sha256=3kNCL8nPi8WxCI_dGc0nunJR7g7gPgG7lz1nzz27CJQ,1345
+gllm_core/utils/google_sheets.py,sha256=v3dr9uPT_Nk50B42opzztduxLgHXuHBffs79DRx-o34,4339
+gllm_core/utils/google_sheets.pyi,sha256=SP-2K84tvaK-eIpPx1_MPBZ9g2WwmBL46YxPmxb6nTU,921
+gllm_core/utils/imports.py,sha256=KiUdjSez1bQTJYhMgSKXdZPgPXsBkL1MbAIqLSpu8Mc,3534
+gllm_core/utils/imports.pyi,sha256=dLGL6C11V5U3Tuc6CY-V2geN12p1WcMs0nvXlOf3_W8,2154
+gllm_core/utils/logger_manager.py,sha256=iWVArF0qpAdFmFknbxEDjKXloDA8g5ZTkj9inyW4EqI,12488
+gllm_core/utils/logger_manager.pyi,sha256=_ezLtErgS24SB42z7WH-crFdZdimsbAVbLj9LMOq4VM,6983
+gllm_core/utils/main_method_resolver.py,sha256=MGA1QARmhATZ977t8dMpbOaygaog7qUrnG4UqyGXx8w,7616
+gllm_core/utils/main_method_resolver.pyi,sha256=_igXFhfT-Kwl3VPRMiODBzuDJUExb0GhY4Udgc5X1NA,2124
+gllm_core/utils/merger_method.py,sha256=YB_jE14w_yMoupd8Ot_PkF4-c736kQJg7_K-_wV5ycY,4597
+gllm_core/utils/merger_method.pyi,sha256=WAXbB8CQ-36jGxoE1bUyviLgp7a_d9_pc7IwZD5u86E,1819
+gllm_core/utils/retry.py,sha256=l3XqOmIRnEE9botH8CaTMV838efHsQz36rBkUuWX8QM,8826
+gllm_core/utils/retry.pyi,sha256=CvjSiIL6HIkjPqV6shqYkveZknS7Wp_gJfWoHxnm7XA,1573
+gllm_core/utils/similarity.py,sha256=Qpe9Fs3U6OgXMbmd7EFEXdHwHOsB79y1eIdq_lK8xc0,835
+gllm_core/utils/similarity.pyi,sha256=FpyLANA2yGbpTvCuPogpyE0rqjtyFsUqqwQ6dpNy300,429
+gllm_core/utils/validation.py,sha256=Yi-xdC48_k5ILtJ_QoE448zpAHxxyQOM1cNH6oBH7x8,741
+gllm_core/utils/validation.pyi,sha256=toxBtRp-VItC_X7sNi-GDd7sjibBdWMrR0q01OI2D7k,385
+gllm_core_binary-0.4.4.dist-info/METADATA,sha256=w-MVryrUwvsuuQ5zbnm56FTe9OwmX4-fqnJMqUNXXOY,4485
+gllm_core_binary-0.4.4.dist-info/WHEEL,sha256=PaP4PvkDyiSc4C6Dhw6ccQmfxsWFrSv-lJQjBshu0hw,105
+gllm_core_binary-0.4.4.dist-info/top_level.txt,sha256=UYoTGvK_Yec95-_QUuVCKEr6PUXb5Lc7Dr-x8SeX9uM,10
+gllm_core_binary-0.4.4.dist-info/RECORD,,

gllm_core_binary-0.4.4.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-macosx_13_0_arm64
+

gllm_core_binary-0.4.4.dist-info/top_level.txt

@@ -0,0 +1 @@
+gllm_core