eventide-sdk 0.1.0__tar.gz

eventide_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,34 @@
+Metadata-Version: 2.4
+Name: eventide-sdk
+Version: 0.1.0
+Summary: Python SDK for the Eventide event gateway
+License: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.25
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
+
+# Eventide Python SDK
+
+Python SDK for the Eventide event gateway, mirroring the reference-agent implementation.
+
+## Usage
+
+```python
+import asyncio
+from eventide import GatewayClient, Event, EventType, Level
+
+async def main():
+    async with GatewayClient("http://127.0.0.1:18081") as client:
+        await client.append(Event(
+            thread_id="t1",
+            turn_id="turn1",
+            type=EventType.TURN_STARTED,
+            payload={"input": {"msg": "hello"}},
+        ))
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```

eventide_sdk-0.1.0/README.md

@@ -0,0 +1,22 @@
+# Eventide Python SDK
+
+Python SDK for the Eventide event gateway, mirroring the reference-agent implementation.
+
+## Usage
+
+```python
+import asyncio
+from eventide import GatewayClient, Event, EventType, Level
+
+async def main():
+    async with GatewayClient("http://127.0.0.1:18081") as client:
+        await client.append(Event(
+            thread_id="t1",
+            turn_id="turn1",
+            type=EventType.TURN_STARTED,
+            payload={"input": {"msg": "hello"}},
+        ))
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```

eventide_sdk-0.1.0/eventide/__init__.py

@@ -0,0 +1,13 @@
+"""eventide-sdk — Python SDK for the Eventide event gateway."""
+
+from .types import SPEC_VERSION, Event, EventType, Level
+from .client import GatewayClient, GatewayError
+
+__all__ = [
+    "SPEC_VERSION",
+    "Event",
+    "EventType",
+    "Level",
+    "GatewayClient",
+    "GatewayError",
+]

eventide_sdk-0.1.0/eventide/client.py

@@ -0,0 +1,94 @@
+"""Gateway client — async HTTP client for POST /events:append."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import List, Optional
+
+import httpx
+
+from .types import Event
+
+
+class GatewayError(Exception):
+    """Raised when the gateway returns a non-2xx response."""
+
+    def __init__(self, status: int, body: str) -> None:
+        super().__init__(f"gateway responded with {status}: {body}")
+        self.status = status
+        self.body = body
+
+
+@dataclass
+class AppendResult:
+    """Result from a successful append call."""
+
+    event_id: str
+    seq: int
+    stream_id: Optional[str] = None
+    duplicated: bool = False
+
+
+class GatewayClient:
+    """
+    Async client for the Eventide event gateway.
+
+    Usage::
+
+        async with GatewayClient("http://127.0.0.1:18081") as client:
+            await client.append(Event(
+                thread_id="t1",
+                turn_id="turn1",
+                type=EventType.TURN_STARTED,
+                payload={"input": {"msg": "hi"}},
+            ))
+    """
+
+    def __init__(self, base_url: str, *, timeout: float = 10.0) -> None:
+        self.base_url = base_url.rstrip("/")
+        self._client = httpx.AsyncClient(timeout=timeout)
+
+    async def __aenter__(self) -> "GatewayClient":
+        return self
+
+    async def __aexit__(self, *exc) -> None:
+        await self.close()
+
+    async def close(self) -> None:
+        """Close the underlying HTTP client."""
+        await self._client.aclose()
+
+    async def append(self, event: Event) -> AppendResult:
+        """
+        Append a single event to the gateway.
+
+        Args:
+            event: The event to send.
+
+        Returns:
+            AppendResult with the assigned event_id, seq, etc.
+
+        Raises:
+            GatewayError: If the gateway returns a non-2xx status.
+        """
+        resp = await self._client.post(
+            f"{self.base_url}/events:append",
+            json={"event": event.to_dict()},
+        )
+        if resp.status_code < 200 or resp.status_code >= 300:
+            raise GatewayError(resp.status_code, resp.text)
+
+        data = resp.json()
+        return AppendResult(
+            event_id=data.get("event_id", ""),
+            seq=data.get("seq", 0),
+            stream_id=data.get("stream_id"),
+            duplicated=data.get("duplicated", False),
+        )
+
+    async def append_all(self, events: List[Event]) -> List[AppendResult]:
+        """Append multiple events sequentially."""
+        results = []
+        for event in events:
+            results.append(await self.append(event))
+        return results

eventide_sdk-0.1.0/eventide/types.py

@@ -0,0 +1,73 @@
+"""Core event types — mirrors internal/eventproto/."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field, asdict
+from enum import Enum
+from typing import Any, Dict, Optional
+
+SPEC_VERSION = "agent-events/1.0"
+
+
+class EventType(str, Enum):
+    """Event type constants — mirrors internal/eventproto/types.go."""
+
+    THREAD_READY = "thread.ready"
+    THREAD_HEARTBEAT = "thread.heartbeat"
+    THREAD_SUSPENDED = "thread.suspended"
+    THREAD_RESUMED = "thread.resumed"
+
+    TURN_STARTED = "turn.started"
+    TURN_INPUT = "turn.input"
+    TURN_COMPLETED = "turn.completed"
+    TURN_FAILED = "turn.failed"
+    TURN_CANCELLED = "turn.cancelled"
+
+    ASSISTANT_DELTA = "assistant.message.delta"
+    ASSISTANT_COMPLETED = "assistant.message.completed"
+
+    STATE_CHECKPOINT = "state.checkpoint"
+
+
+class Level(str, Enum):
+    """Event level constants — mirrors internal/eventproto/event.go."""
+
+    DEBUG = "debug"
+    INFO = "info"
+    WARN = "warn"
+    ERROR = "error"
+
+
+@dataclass
+class Event:
+    """
+    Represents a single event to send to the gateway.
+
+    Only ``thread_id``, ``turn_id``, ``type``, and ``level`` are required.
+    The gateway auto-fills ``spec_version``, ``event_id``, ``ts``, and ``seq``
+    when omitted.
+    """
+
+    thread_id: str
+    turn_id: str
+    type: str  # use EventType values
+    level: str = Level.INFO  # use Level values
+    payload: Any = field(default_factory=dict)
+
+    # Optional — auto-filled by gateway when omitted/empty
+    spec_version: str = SPEC_VERSION
+    event_id: str = ""
+    ts: str = ""
+    seq: int = 0
+
+    # Optional metadata
+    content_type: Optional[str] = None
+    source: Optional[Dict[str, Any]] = None
+    trace: Optional[Dict[str, Any]] = None
+    tags: Optional[Dict[str, str]] = None
+
+    def to_dict(self) -> dict:
+        """Serialize to the JSON structure expected by POST /events:append."""
+        d = asdict(self)
+        # Remove None optional fields to keep the payload clean
+        return {k: v for k, v in d.items() if v is not None}

eventide_sdk-0.1.0/eventide_sdk.egg-info/PKG-INFO

@@ -0,0 +1,34 @@
+Metadata-Version: 2.4
+Name: eventide-sdk
+Version: 0.1.0
+Summary: Python SDK for the Eventide event gateway
+License: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.25
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
+
+# Eventide Python SDK
+
+Python SDK for the Eventide event gateway, mirroring the reference-agent implementation.
+
+## Usage
+
+```python
+import asyncio
+from eventide import GatewayClient, Event, EventType, Level
+
+async def main():
+    async with GatewayClient("http://127.0.0.1:18081") as client:
+        await client.append(Event(
+            thread_id="t1",
+            turn_id="turn1",
+            type=EventType.TURN_STARTED,
+            payload={"input": {"msg": "hello"}},
+        ))
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```

eventide_sdk-0.1.0/eventide_sdk.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+eventide/__init__.py
+eventide/client.py
+eventide/types.py
+eventide_sdk.egg-info/PKG-INFO
+eventide_sdk.egg-info/SOURCES.txt
+eventide_sdk.egg-info/dependency_links.txt
+eventide_sdk.egg-info/requires.txt
+eventide_sdk.egg-info/top_level.txt

eventide_sdk-0.1.0/eventide_sdk.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

eventide_sdk-0.1.0/eventide_sdk.egg-info/requires.txt

@@ -0,0 +1,5 @@
+httpx>=0.25
+
+[dev]
+pytest>=7.0
+pytest-asyncio>=0.21

eventide_sdk-0.1.0/eventide_sdk.egg-info/top_level.txt

@@ -0,0 +1 @@
+eventide

eventide_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,20 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "eventide-sdk"
+version = "0.1.0"
+description = "Python SDK for the Eventide event gateway"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+dependencies = [
+    "httpx>=0.25",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-asyncio>=0.21",
+]

eventide_sdk-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+