gllm-core-binary 0.4.4b3__cp312-cp312-win_amd64.whl → 0.4.5__cp312-cp312-win_amd64.whl

gllm_core/constants.pyi

@@ -2,26 +2,26 @@ from enum import IntEnum, StrEnum
 
 class EventLevel(IntEnum):
     """Defines event levels for the event emitter module."""
-    TRACE = 0
-    DEBUG = 1
-    INFO = 2
-    WARN = 3
-    ERROR = 4
-    FATAL = 5
+    TRACE: int
+    DEBUG: int
+    INFO: int
+    WARN: int
+    ERROR: int
+    FATAL: int
 
 class EventType(StrEnum):
     """Defines event types for the event emitter module."""
-    ACTIVITY = 'activity'
-    CODE = 'code'
-    REFERENCE = 'reference'
-    RESPONSE = 'response'
-    STATUS = 'status'
-    THINKING = 'thinking'
+    ACTIVITY: str
+    CODE: str
+    REFERENCE: str
+    RESPONSE: str
+    STATUS: str
+    THINKING: str
 
 class EventTypeSuffix(StrEnum):
     """Defines suffixes for block based event types."""
-    START = '_start'
-    END = '_end'
+    START: str
+    END: str
 
 class DefaultChunkMetadata:
     """Defines constants for default chunk metadata keys."""
@@ -31,6 +31,6 @@ class DefaultChunkMetadata:
 
 class LogMode(StrEnum):
     """Defines supported log modes for the SDK logging system."""
-    TEXT = 'text'
-    SIMPLE = 'simple'
-    JSON = 'json'
+    TEXT: str
+    SIMPLE: str
+    JSON: str

gllm_core/event/event_emitter.pyi

@@ -4,7 +4,7 @@ from gllm_core.event.handler import ConsoleEventHandler as ConsoleEventHandler,
 from gllm_core.event.handler.event_handler import BaseEventHandler as BaseEventHandler
 from gllm_core.event.hook.event_hook import BaseEventHook as BaseEventHook
 from gllm_core.schema import Event as Event
-from gllm_core.utils import validate_string_enum as validate_string_enum
+from gllm_core.utils import validate_enum as validate_enum
 from typing import AsyncGenerator
 
 class EventEmitter:

gllm_core/event/handler/event_handler.pyi

@@ -1,4 +1,3 @@
-import abc
 from _typeshed import Incomplete
 from abc import ABC, abstractmethod
 from gllm_core.constants import EventType as EventType, EventTypeSuffix as EventTypeSuffix
@@ -8,7 +7,7 @@ from gllm_core.utils import LoggerManager as LoggerManager
 DEFAULT_COLOR_MAP: Incomplete
 DEFAULT_COLOR: str
 
-class BaseEventHandler(ABC, metaclass=abc.ABCMeta):
+class BaseEventHandler(ABC):
     """An abstract base class for all event handlers used throughout the Gen AI applications.
 
     Attributes:

gllm_core/event/hook/event_hook.pyi

@@ -1,8 +1,7 @@
-import abc
 from abc import ABC, abstractmethod
 from gllm_core.schema import Event as Event
 
-class BaseEventHook(ABC, metaclass=abc.ABCMeta):
+class BaseEventHook(ABC):
     """An abstract base class for all event hooks."""
     @abstractmethod
     async def __call__(self, event: Event) -> Event:

gllm_core/utils/__init__.pyi

@@ -8,6 +8,6 @@ from gllm_core.utils.logger_manager import LoggerManager as LoggerManager
 from gllm_core.utils.main_method_resolver import MainMethodResolver as MainMethodResolver
 from gllm_core.utils.merger_method import MergerMethod as MergerMethod
 from gllm_core.utils.retry import RetryConfig as RetryConfig, retry as retry
-from gllm_core.utils.validation import validate_string_enum as validate_string_enum
+from gllm_core.utils.validation import validate_enum as validate_enum, validate_string_enum as validate_string_enum
 
-__all__ = ['BinaryHandlingStrategy', 'ChunkMetadataMerger', 'LoggerManager', 'MainMethodResolver', 'MergerMethod', 'RunAnalyzer', 'RetryConfig', 'asyncify', 'get_default_portal', 'binary_handler_factory', 'format_chunk_message', 'get_placeholder_keys', 'load_gsheets', 'syncify', 'retry', 'validate_string_enum']
+__all__ = ['BinaryHandlingStrategy', 'ChunkMetadataMerger', 'LoggerManager', 'MainMethodResolver', 'MergerMethod', 'RunAnalyzer', 'RetryConfig', 'asyncify', 'get_default_portal', 'binary_handler_factory', 'format_chunk_message', 'get_placeholder_keys', 'load_gsheets', 'syncify', 'retry', 'validate_enum', 'validate_string_enum']

gllm_core/utils/analyzer.pyi

@@ -6,11 +6,11 @@ from typing import Any, Callable
 
 class ParameterKind(StrEnum):
     """Enum representing the different kinds of parameters a method can have."""
-    POSITIONAL_ONLY = 'positional_only'
-    POSITIONAL_OR_KEYWORD = 'positional_or_keyword'
-    VAR_POSITIONAL = 'var_positional'
-    KEYWORD_ONLY = 'keyword_only'
-    VAR_KEYWORD = 'var_keyword'
+    POSITIONAL_ONLY: str
+    POSITIONAL_OR_KEYWORD: str
+    VAR_POSITIONAL: str
+    KEYWORD_ONLY: str
+    VAR_KEYWORD: str
 
 class ParameterInfo(BaseModel):
     """Model representing information about a method parameter.
@@ -48,9 +48,9 @@ class ArgUsages(BaseModel):
 
 class RunArgumentUsageType(StrEnum):
     """Enum representing the different types of argument usage in a run."""
-    FULL_PASS = 'full_pass'
-    REQUIRED = 'required'
-    OPTIONAL = 'optional'
+    FULL_PASS: str
+    REQUIRED: str
+    OPTIONAL: str
 
 class RunProfile(BaseModel):
     """Model representing the profile of a run.

gllm_core/utils/binary_handler_factory.pyi

@@ -10,10 +10,10 @@ class BinaryHandlingStrategy(StrEnum):
         HEX (str): Encode binary data to hex.
         SHOW_SIZE (str): Show the size of binary data.
     """
-    SKIP = 'skip'
-    BASE64 = 'base64'
-    HEX = 'hex'
-    SHOW_SIZE = 'show_size'
+    SKIP: str
+    BASE64: str
+    HEX: str
+    SHOW_SIZE: str
 
 def binary_handler_factory(handling_type: BinaryHandlingStrategy | str) -> Callable[[bytes], str | None]:
     """Factory function to create appropriate binary data handler.

gllm_core/utils/concurrency.pyi

@@ -1,5 +1,5 @@
 import anyio
-from anyio.abc import BlockingPortal as BlockingPortal
+from anyio.abc import BlockingPortal
 from typing import Awaitable, Callable, ParamSpec, TypeVar
 
 P = ParamSpec('P')

gllm_core/utils/google_sheets.pyi

@@ -1,5 +1,3 @@
-from gspread import Client as Client, Spreadsheet as Spreadsheet, Worksheet as Worksheet
-
 def load_gsheets(client_email: str, private_key: str, sheet_id: str, worksheet_id: str) -> list[dict[str, str]]:
     """Loads data from a Google Sheets worksheet.
 

gllm_core/utils/validation.pyi

@@ -1,5 +1,21 @@
-from enum import StrEnum
+from _typeshed import Incomplete
+from enum import Enum, StrEnum as StrEnum
+from gllm_core.utils.logger_manager import LoggerManager as LoggerManager
+from typing import TypeVar
 
+E = TypeVar('E', bound=Enum)
+logger: Incomplete
+
+def validate_enum(enum_type: type[E], value: object) -> None:
+    """Validates that the provided value is a valid enum value.
+
+    Args:
+        enum_type (type[E]): The type of the enum.
+        value (object): The value to validate.
+
+    Raises:
+        ValueError: If the provided value is not a valid enum value.
+    """
 def validate_string_enum(enum_type: type[StrEnum], value: str) -> None:
     """Validates that the provided value is a valid string enum value.
 

gllm_core.pyi

@@ -18,7 +18,7 @@ import gllm_core.event.handler.ConsoleEventHandler
 import gllm_core.event.handler.PrintEventHandler
 import gllm_core.event.handler.StreamEventHandler
 import gllm_core.schema.Event
-import gllm_core.utils.validate_string_enum
+import gllm_core.utils.validate_enum
 import rich
 import rich.console
 import abc

gllm_core_binary-0.4.5.dist-info/METADATA

@@ -0,0 +1,177 @@
+Metadata-Version: 2.2
+Name: gllm-core-binary
+Version: 0.4.5
+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-core
+```
+
+---
+
+### 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.4b3.dist-info → gllm_core_binary-0.4.5.dist-info}/RECORD

@@ -1,21 +1,21 @@
-gllm_core.cp312-win_amd64.pyd,sha256=KPvLpwTL7Zkmz0jqCXwWLGrcypO07Bu3i6yELLZKnLU,1217024
-gllm_core.pyi,sha256=n1D4ZCjhQUKv7qxTYLWh-afK6ECPZCddwckzt6afO2w,1446
+gllm_core.cp312-win_amd64.pyd,sha256=fW_pFjUNIfo8NF14zcbF8G7m4eCOznRXC04hqyeweao,1220608
+gllm_core.pyi,sha256=yaptQynjmnHkD9cSX6dNIU6v2MRB_3yafwgtuoFPbh4,1439
 gllm_core/__init__.pyi,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-gllm_core/constants.pyi,sha256=9M5UxEkdttu4fSJTLxhjt7q1xTRYbjTFheM5EjQ5Bs4,904
+gllm_core/constants.pyi,sha256=HfDsdHcPhUsSniEp_fScuVnSuhpJOM17rQIU2dV2DY8,843
 gllm_core/adapters/__init__.pyi,sha256=N8JBGr2mPUMAGaMd__7XxGr2NAzfaFMuNH15QkSfbrA,187
 gllm_core/adapters/tool/__init__.pyi,sha256=zRmMo1ilDaYF-cErfkQqy8zGnArHebdWmox-P34_7fI,244
 gllm_core/adapters/tool/google_adk.pyi,sha256=0awaKRXmmK5NiAP9vNNYjMARDPWfWyQqy29k3WHoX2s,953
 gllm_core/adapters/tool/langchain.pyi,sha256=LBqox8xFm6jSxPfBEftJr_zUmXwPk_qHNwU3bZaphhE,855
 gllm_core/event/__init__.pyi,sha256=HVs5C80lFzVEH7mO8KJTUqEPi_7KyPvNeMLuoG-hDeE,177
-gllm_core/event/event_emitter.pyi,sha256=dzhlOGnA2h5-OSRZHt-AJ-THul-rDUatfwr6dyYzYu8,7297
+gllm_core/event/event_emitter.pyi,sha256=PDW4OtFUjjYxWjOINLOr42hCbzaTmGMvYaRKpLlX4-Y,7283
 gllm_core/event/messenger.pyi,sha256=8Nvra-a7RqnfX0PAtm-Of5M8CvsYr0L_1k3HgdNCR5I,3190
 gllm_core/event/handler/__init__.pyi,sha256=gZ21Fjjog3-e3-_Xv5sTpX9_Mx8X2LUzTrqp_tPisCg,377
 gllm_core/event/handler/console_event_handler.pyi,sha256=eCv0SaZEpbu8W2jQPLnWwXNzhGOSM5KAtDVUYfvlvMs,1494
-gllm_core/event/handler/event_handler.pyi,sha256=chEYnw3Rp9Lk3Cz4dSn6EVlzje4BG-SlM82J-4UE5Hw,2153
+gllm_core/event/handler/event_handler.pyi,sha256=tC6q1-pvIBhX16uaryeLcpyf5Z6vQgjEVf3vo257gCo,2118
 gllm_core/event/handler/print_event_handler.pyi,sha256=D_xNtpcBsGl7NVSCvFKEGvaUqfMTxPaQV8zXECwmZ2Q,1674
 gllm_core/event/handler/stream_event_handler.pyi,sha256=5faGSFQLBN7XMqd4nIfGkdTBI_ALVaE-fmxVAjzca9w,2908
 gllm_core/event/hook/__init__.pyi,sha256=gSDHYl0yi00zHHMRvU_Eg8qLqsGHESTvoNE3MXig-g0,149
-gllm_core/event/hook/event_hook.pyi,sha256=rMatofdNAwHI65ya_7-q3NAfmTuKhc2WkXeiGPAvcKI,600
+gllm_core/event/hook/event_hook.pyi,sha256=IV5oq-ZZqrLG_hvdibphCpWDYu9e5lYuarQxt8dn76Y,565
 gllm_core/event/hook/json_stringify_event_hook.pyi,sha256=I-QxbaLc4rEyqhW_f4INN5UxBg_ZofHHN1HQKfPJ7rs,585
 gllm_core/schema/__init__.pyi,sha256=X7Gv3xgtl4Ylzsg9iuGgjJPkQey7OdvvIC_X1e5_LAI,310
 gllm_core/schema/chunk.pyi,sha256=ZVYQitMtvMStiFssnTCgtSIcj30VSsK2dKscSysl3R4,2378
@@ -23,22 +23,22 @@ gllm_core/schema/component.pyi,sha256=fghUD8QJRXjjUT2jn64dkM_KjMv6MV9OAQUXjc7xsD
 gllm_core/schema/event.pyi,sha256=Yd74uSWhIO1lx0_p70rYt-LMz4FZHbbbqJP7xhVh_pY,1335
 gllm_core/schema/schema_generator.pyi,sha256=ToadC6UKEq35k32wUK1VaMKiICRtENXUYdAQOMlTg3U,1445
 gllm_core/schema/tool.pyi,sha256=T5TufJZPYUzYoSPZBX0FkqgZ9u03VAIsZdwvY1PS7nw,8848
-gllm_core/utils/__init__.pyi,sha256=ZFilGPXXqc2JGwy8AV8N7pf6zmtd9clzuk310PIGkBs,1359
-gllm_core/utils/analyzer.pyi,sha256=M48PRor76L5eAQBpSqpv3EkZ4kU1t5Zm3CPFd34dxWM,4470
-gllm_core/utils/binary_handler_factory.pyi,sha256=imcuCL2oa-7uwTnC_vI-_KvE1hGu1-5U4ZiF5fShDmQ,1739
+gllm_core/utils/__init__.pyi,sha256=KTUv1RiXQpr8Ef2owMYWUrAB7U_LpC9lTb0-rcHx0NM,1408
+gllm_core/utils/analyzer.pyi,sha256=E3xvelXssLGrKMRvHn_Ap-ao3dhCLPM-q2Pr1vHAdgw,4372
+gllm_core/utils/binary_handler_factory.pyi,sha256=Cpsv8gvCuD52c-q8sjZizSiRHV0h5sVdgYP9uMgKWbg,1717
 gllm_core/utils/chunk_metadata_merger.pyi,sha256=J1lHTFV-0IiC6xKzzC7x1D1wBoki249muEU2HrF6C58,2317
-gllm_core/utils/concurrency.pyi,sha256=n_Mb9D_2hJAQ7VSwDBxhgmDv7hyFRKevDlhcHoAjvyA,3959
+gllm_core/utils/concurrency.pyi,sha256=S_B9BLhVzOOBANknZW0eVTKFHVjCYI3vD7zwLQfawvI,3941
 gllm_core/utils/event_formatter.pyi,sha256=ocQ_Ev_XorRhLzj0c2szlclz8V3_Ysbg6qHmjhmur3k,1375
-gllm_core/utils/google_sheets.pyi,sha256=IjKdc7H3hBLAp8I8jxnwDfKP79D1EIBIRQKKFTUNqjM,939
+gllm_core/utils/google_sheets.pyi,sha256=S3ArLRoWqGZpzqmuQ48xVVOZ9OjLILdD8Ez51QfufFM,847
 gllm_core/utils/imports.pyi,sha256=-KM0pyw7yFVCUZjHjoNBRFgEnI8hlr0pquKuhcA2X9M,2196
 gllm_core/utils/logger_manager.pyi,sha256=IDRgA-5jRDu4miO5Ru_tFJHql2JlHdr1GvZdmdS9Sg8,7159
 gllm_core/utils/main_method_resolver.pyi,sha256=dHozSqFMwCyVorQ0ZE9N-c2V4PkpF8FdU1VGGPvTjK4,2178
 gllm_core/utils/merger_method.pyi,sha256=JsgHnO47cqenqNxCrHqhAR-nnR_dEqE-7wprVrd8ZFg,1868
 gllm_core/utils/retry.pyi,sha256=KxlPzURzZfCSgKC44v98nR2bqamzHqtbRuXLDEuX29c,1614
 gllm_core/utils/similarity.pyi,sha256=HmSxE5VfPwYZYih_bSIz8QRDbkouO_jij-FX6TSCEdM,439
-gllm_core/utils/validation.pyi,sha256=-RdMmb8afH7F7q4Ao7x6FbwaDfxUHn3hA3WiOgzB-3s,397
+gllm_core/utils/validation.pyi,sha256=NFfyDCYsqHv44Z_5RqpSUEiuETpqH5Eoia5xwC4n1MU,938
 gllm_core.build/.gitignore,sha256=aEiIwOuxfzdCmLZe4oB1JsBmCUxwG8x-u-HBCV9JT8E,1
-gllm_core_binary-0.4.4b3.dist-info/METADATA,sha256=twBMLynLeu3Z9RMIH4bBPynGtO4JBYoKxFvBo9H3s0Y,4681
-gllm_core_binary-0.4.4b3.dist-info/WHEEL,sha256=x5rgv--I0NI0IT1Lh9tN1VG2cI637p3deednwYLKnxc,96
-gllm_core_binary-0.4.4b3.dist-info/top_level.txt,sha256=UYoTGvK_Yec95-_QUuVCKEr6PUXb5Lc7Dr-x8SeX9uM,10
-gllm_core_binary-0.4.4b3.dist-info/RECORD,,
+gllm_core_binary-0.4.5.dist-info/METADATA,sha256=LzXLUK6g9BiW6kUOtm5CLHSBS0Hsm8mrnJlmApPcJNA,4657
+gllm_core_binary-0.4.5.dist-info/WHEEL,sha256=x5rgv--I0NI0IT1Lh9tN1VG2cI637p3deednwYLKnxc,96
+gllm_core_binary-0.4.5.dist-info/top_level.txt,sha256=UYoTGvK_Yec95-_QUuVCKEr6PUXb5Lc7Dr-x8SeX9uM,10
+gllm_core_binary-0.4.5.dist-info/RECORD,,

gllm_core_binary-0.4.4b3.dist-info/METADATA

@@ -1,113 +0,0 @@
-Metadata-Version: 2.2
-Name: gllm-core-binary
-Version: 0.4.4b3
-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: poetry<3.0.0,>=2.1.3
-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
-Requires-Dist: virtualenv==20.30.0
-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
-1. Python 3.11+ - [Install here](https://www.python.org/downloads/)
-2. Pip (if using Pip) - [Install here](https://pip.pypa.io/en/stable/installation/)
-3. Poetry 2.1.4+ - [Install here](https://python-poetry.org/docs/#installation)
-4. Git (if using Git) - [Install here](https://git-scm.com/downloads)
-5. gcloud CLI (for authentication) - [Install here](https://cloud.google.com/sdk/docs/install)
-6. For git installation, access to the [GDP Labs SDK github repository](https://github.com/GDP-ADMIN/gl-sdk)
-
-### 1. Installation from Artifact Registry
-Choose one of the following methods to install the package:
-
-#### Using pip
-```bash
-pip install gllm-core-binary
-```
-
-#### Using Poetry
-```bash
-poetry add gllm-core-binary
-```
-
-### 2. Development Installation (Git)
-For development purposes, you can install directly from the Git repository:
-```bash
-git clone git@github.com:GDP-ADMIN/gl-sdk.git
-cd gl-sdk/libs/gllm-core
-```
-
-## Local Development Setup
-
-### Quick Setup (Recommended)
-For local development with editable gllm packages, use the provided Makefile:
-
-```bash
-# Complete setup: installs Poetry, configures auth, installs packages, sets up pre-commit
-make setup
-```
-
-The following are the available Makefile targets:
-
-1. `make setup` - Complete development setup (recommended for new developers)
-2. `make install-poetry` - Install or upgrade Poetry to the latest version
-3. `make auth` - Configure authentication for internal repositories
-4. `make install` - Install all dependencies
-5. `make install-pre-commit` - Set up pre-commit hooks
-6. `make update` - Update dependencies
-
-### Manual Development Setup (Legacy)
-If you prefer to manage dependencies manually:
-
-1. Go to root folder of `gllm-core` module, e.g. `cd libs/gllm-core`.
-2. Run `poetry shell` to create a virtual environment.
-3. Run `poetry lock` to create a lock file if you haven't done it yet.
-4. Run `poetry install` to install the `gllm-core` requirements for the first time.
-5. Run `poetry update` if you update any dependency module version at `pyproject.toml`.
-
-
-## Contributing
-Please refer to this [Python Style Guide](https://docs.google.com/document/d/1uRggCrHnVfDPBnG641FyQBwUwLoFw0kTzNqRm92vUwM/edit?usp=sharing)
-to get information about code style, documentation standard, and SCA that you need to use when contributing to this project
-
-### Getting Started with Development
-1. Clone the repository and navigate to the gllm-core directory
-2. Run `make setup` to set up your development environment
-3. Run `which python` to get the path to be referenced at Visual Studio Code interpreter path (`Ctrl`+`Shift`+`P` or `Cmd`+`Shift`+`P`)
-4. Try running the unit test to see if it's working:
-```bash
-poetry run pytest -s tests/unit_tests/
-```
-5. When you want to update the dependencies, run `make update`