genailit 0.0.1__tar.gz

genailit-0.0.1/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,43 @@
+# 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/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "genailit"
+version = "0.0.1"
+description = "Open source Python library for multi-agent web interfaces."
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+  "pydantic>=2",
+]
+
+[project.optional-dependencies]
+dev = [
+  "pytest",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/genailit"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+

genailit-0.0.1/src/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-0.0.1/src/genailit/adapters/__init__.py

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

genailit-0.0.1/src/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-0.0.1/src/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-0.0.1/src/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/tests/conftest.py

@@ -0,0 +1,12 @@
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+
+ROOT = Path(__file__).resolve().parents[1]
+SRC = ROOT / "src"
+
+if str(SRC) not in sys.path:
+    sys.path.insert(0, str(SRC))
+

genailit-0.0.1/tests/test_base_adapter.py

@@ -0,0 +1,33 @@
+import pytest
+
+from genailit import AdapterContext, BaseAgentAdapter, GenAILitEvent, TelemetryStore
+
+
+def test_base_agent_adapter_is_abstract() -> None:
+    with pytest.raises(TypeError):
+        BaseAgentAdapter()  # type: ignore[abstract]
+
+
+def test_base_agent_adapter_runs_and_records_telemetry() -> None:
+    class DemoAdapter(BaseAgentAdapter):
+        def build_events(self, context: AdapterContext):
+            yield GenAILitEvent(name="ready", payload={"session_id": context.session_id})
+
+    telemetry = TelemetryStore()
+    context = AdapterContext(session_id="abc", telemetry=telemetry)
+
+    events = DemoAdapter().run(context)
+
+    assert events == (GenAILitEvent(name="ready", payload={"session_id": "abc"}),)
+    assert telemetry.snapshot() == events
+
+
+def test_adapter_context_merges_metadata() -> None:
+    context = AdapterContext(session_id="abc", metadata={"alpha": 1})
+
+    updated = context.with_metadata(beta=2)
+
+    assert updated.session_id == "abc"
+    assert updated.metadata == {"alpha": 1, "beta": 2}
+    assert context.metadata == {"alpha": 1}
+

genailit-0.0.1/tests/test_events.py

@@ -0,0 +1,16 @@
+import pytest
+
+from genailit import GenAILitEvent
+
+
+def test_genailit_event_models_name_and_payload() -> None:
+    event = GenAILitEvent(name="step_started", payload={"step": 1})
+
+    assert event.name == "step_started"
+    assert event.payload == {"step": 1}
+
+
+def test_genailit_event_rejects_unknown_fields() -> None:
+    with pytest.raises(ValueError):
+        GenAILitEvent(name="x", unknown=True)  # type: ignore[call-arg]
+

genailit-0.0.1/tests/test_telemetry.py

@@ -0,0 +1,17 @@
+from genailit import GenAILitEvent, TelemetryStore
+
+
+def test_telemetry_store_records_and_clears_events() -> None:
+    store = TelemetryStore()
+    first = GenAILitEvent(name="a")
+    second = GenAILitEvent(name="b")
+
+    store.record(first)
+    store.extend([second])
+
+    assert store.snapshot() == (first, second)
+
+    store.clear()
+
+    assert store.snapshot() == ()
+