genailit 0.0.1__py3-none-any.whl

genailit/__init__.py

@@ -0,0 +1,13 @@
+from .adapters import AdapterContext, BaseAgentAdapter
+from .events import GenAILitEvent
+from .telemetry import TelemetryStore
+
+__all__ = [
+    "AdapterContext",
+    "BaseAgentAdapter",
+    "GenAILitEvent",
+    "TelemetryStore",
+]
+
+__version__ = "0.0.1"
+

genailit/adapters/__init__.py

@@ -0,0 +1,7 @@
+from .base import AdapterContext, BaseAgentAdapter
+
+__all__ = [
+    "AdapterContext",
+    "BaseAgentAdapter",
+]
+

genailit/adapters/base.py

@@ -0,0 +1,38 @@
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from dataclasses import dataclass, field
+from collections.abc import Iterable, Mapping
+from typing import Any
+
+from ..events import GenAILitEvent
+from ..telemetry import TelemetryStore
+
+
+@dataclass(frozen=True, slots=True)
+class AdapterContext:
+    session_id: str
+    telemetry: TelemetryStore | None = None
+    metadata: Mapping[str, Any] = field(default_factory=dict)
+
+    def with_metadata(self, **items: Any) -> "AdapterContext":
+        merged = dict(self.metadata)
+        merged.update(items)
+        return AdapterContext(
+            session_id=self.session_id,
+            telemetry=self.telemetry,
+            metadata=merged,
+        )
+
+
+class BaseAgentAdapter(ABC):
+    @abstractmethod
+    def build_events(self, context: AdapterContext) -> Iterable[GenAILitEvent]:
+        raise NotImplementedError
+
+    def run(self, context: AdapterContext) -> tuple[GenAILitEvent, ...]:
+        events = tuple(self.build_events(context))
+        if context.telemetry is not None:
+            context.telemetry.extend(events)
+        return events
+

genailit/events.py

@@ -0,0 +1,13 @@
+from __future__ import annotations
+
+from typing import Any
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class GenAILitEvent(BaseModel):
+    model_config = ConfigDict(extra="forbid", frozen=True)
+
+    name: str
+    payload: dict[str, Any] = Field(default_factory=dict)
+

genailit/telemetry.py

@@ -0,0 +1,23 @@
+from __future__ import annotations
+
+from collections.abc import Iterable
+
+from .events import GenAILitEvent
+
+
+class TelemetryStore:
+    def __init__(self) -> None:
+        self._events: list[GenAILitEvent] = []
+
+    def record(self, event: GenAILitEvent) -> None:
+        self._events.append(event)
+
+    def extend(self, events: Iterable[GenAILitEvent]) -> None:
+        self._events.extend(events)
+
+    def snapshot(self) -> tuple[GenAILitEvent, ...]:
+        return tuple(self._events)
+
+    def clear(self) -> None:
+        self._events.clear()
+

genailit-0.0.1.dist-info/METADATA

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: genailit
+Version: 0.0.1
+Summary: Open source Python library for multi-agent web interfaces.
+Requires-Python: >=3.10
+Requires-Dist: pydantic>=2
+Provides-Extra: dev
+Requires-Dist: pytest; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# GenAILit
+
+GenAILit is a small Python base for building web interfaces for multi-agent systems.
+
+This milestone only includes the package foundation:
+
+- `GenAILitEvent`
+- `TelemetryStore`
+- `AdapterContext`
+- `BaseAgentAdapter`
+
+## Requirements
+
+- Python 3.10+
+- `pydantic>=2`
+- `pytest` for tests
+
+## Install
+
+```bash
+pip install genailit
+```
+
+## Example
+
+```python
+from genailit import AdapterContext, BaseAgentAdapter, GenAILitEvent, TelemetryStore
+
+
+class EchoAdapter(BaseAgentAdapter):
+    def build_events(self, context: AdapterContext):
+        yield GenAILitEvent(name="ready")
+
+
+telemetry = TelemetryStore()
+context = AdapterContext(session_id="demo", telemetry=telemetry)
+events = EchoAdapter().run(context)
+```
+
+## Scope
+
+This milestone intentionally does not add LangGraph, React, CLI commands, or FastAPI application code.
+

genailit-0.0.1.dist-info/RECORD

@@ -0,0 +1,8 @@
+genailit/__init__.py,sha256=0cDd9aj0eXEbOGNE6ykqidoKK6cGICnxQ_Sb6AFegeE,255
+genailit/events.py,sha256=UJdWdU2S6PutyLWfYlS8XncP7A2aOCfKCDhCkG2VPpQ,277
+genailit/telemetry.py,sha256=5YU3Sa7QYHNVnlrjtQVSklkhJxJz7jMra9r9vJQ4tEQ,548
+genailit/adapters/__init__.py,sha256=JgQhzeREXjo-Ca7wnm4I6_7YmdVx_l7JTPshw8Dmt2Q,113
+genailit/adapters/base.py,sha256=Cw7F0-_2L54elLiwX8WMIXjVjQgXVw4LMNmsMZ7P7gM,1121
+genailit-0.0.1.dist-info/METADATA,sha256=RJeSE-NyL2VK7iU9WykkpTnbUCiCPS7gAzg2FmymRSA,1108
+genailit-0.0.1.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+genailit-0.0.1.dist-info/RECORD,,

genailit-0.0.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any