sannex-agent 0.1.0__tar.gz

sannex_agent-0.1.0/PKG-INFO

@@ -0,0 +1,49 @@
+Metadata-Version: 2.5
+Name: sannex-agent
+Version: 0.1.0
+Summary: Official Python Telemetry & Monitoring Client for Sannex AI Operations
+Project-URL: Homepage, https://sannex.ng
+Project-URL: Repository, https://github.com/sannex/sannex-agent
+Author-email: Sannex Tech LTD <info@sannex.ng>
+License: MIT
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.24.0
+Description-Content-Type: text/markdown
+
+# sannex-agent (Python SDK)
+
+Official, ultra-lightweight Python client for Sannex AI Operations, telemetry streaming, and dynamic remote configuration sync.
+
+## Installation
+
+```bash
+pip install sannex-agent
+```
+
+## Quick Start
+
+```python
+from sannex_agent import SannexClient
+
+# Initialize client
+client = SannexClient(api_key="your_sannex_api_key")
+
+# Track customer interaction / transaction asynchronously
+client.track(
+    channel="whatsapp",
+    customer_id="+2348012345678",
+    event="payment_success",
+    amount=25000.0,
+    metadata={"order_id": "ORD-123456", "gateway": "paystack"}
+)
+
+# Fetch dynamic system prompts and knowledge base configs
+config = client.get_config()
+print(config)
+
+# Graceful shutdown
+client.close()
+```
+
+## License
+MIT

sannex_agent-0.1.0/README.md

@@ -0,0 +1,37 @@
+# sannex-agent (Python SDK)
+
+Official, ultra-lightweight Python client for Sannex AI Operations, telemetry streaming, and dynamic remote configuration sync.
+
+## Installation
+
+```bash
+pip install sannex-agent
+```
+
+## Quick Start
+
+```python
+from sannex_agent import SannexClient
+
+# Initialize client
+client = SannexClient(api_key="your_sannex_api_key")
+
+# Track customer interaction / transaction asynchronously
+client.track(
+    channel="whatsapp",
+    customer_id="+2348012345678",
+    event="payment_success",
+    amount=25000.0,
+    metadata={"order_id": "ORD-123456", "gateway": "paystack"}
+)
+
+# Fetch dynamic system prompts and knowledge base configs
+config = client.get_config()
+print(config)
+
+# Graceful shutdown
+client.close()
+```
+
+## License
+MIT

sannex_agent-0.1.0/pyproject.toml

@@ -0,0 +1,21 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "sannex-agent"
+version = "0.1.0"
+description = "Official Python Telemetry & Monitoring Client for Sannex AI Operations"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [
+    { name = "Sannex Tech LTD", email = "info@sannex.ng" }
+]
+dependencies = [
+    "httpx>=0.24.0",
+]
+
+[project.urls]
+Homepage = "https://sannex.ng"
+Repository = "https://github.com/sannex/sannex-agent"

sannex_agent-0.1.0/sannex_agent/__init__.py

@@ -0,0 +1,3 @@
+from .client import SannexClient
+
+__all__ = ["SannexClient"]

sannex_agent-0.1.0/sannex_agent/client.py

@@ -0,0 +1,119 @@
+import queue
+import threading
+import time
+from typing import Optional, Dict, Any, List
+import httpx
+
+
+class SannexClient:
+    """Official Python Telemetry & Remote Config Client for Sannex AI Operations."""
+
+    def __init__(
+        self,
+        api_key: str,
+        host: str = "https://api.sannex.ng",
+        flush_interval: float = 1.0,
+        max_queue_size: int = 1000,
+    ):
+        if not api_key:
+            raise ValueError("api_key must not be empty.")
+        self.api_key = api_key
+        self.host = host.rstrip("/")
+        self.endpoint = f"{self.host}/v1/events"
+        self.config_endpoint = f"{self.host}/v1/tenants/config"
+        self.flush_interval = flush_interval
+        self._queue: queue.Queue = queue.Queue(maxsize=max_queue_size)
+        self._running = True
+        self._client = httpx.Client(timeout=5.0)
+
+        self._worker_thread = threading.Thread(target=self._worker, daemon=True)
+        self._worker_thread.start()
+
+    def track(
+        self,
+        channel: str,
+        customer_id: str,
+        event: str,
+        status: str = "success",
+        amount: float = 0.0,
+        metadata: Optional[Dict[str, Any]] = None,
+    ) -> None:
+        """Enqueue an event to be dispatched asynchronously without blocking the caller."""
+        payload = {
+            "channel": channel,
+            "customer_id": str(customer_id),
+            "event": event,
+            "status": status,
+            "amount": float(amount),
+            "metadata": metadata or {},
+            "timestamp": time.time(),
+        }
+        try:
+            self._queue.put_nowait(payload)
+        except queue.Full:
+            pass  # Drop telemetry safely rather than degrading host performance
+
+    def get_config(self) -> Dict[str, Any]:
+        """Fetches dynamic system prompts, LLM parameters, catalogs, and knowledge base documents."""
+        try:
+            res = self._client.get(
+                self.config_endpoint,
+                headers={"Authorization": f"Bearer {self.api_key}"},
+            )
+            if res.status_code == 200:
+                return res.json()
+        except Exception:
+            pass
+        return {"status": "error", "config": {}, "knowledge_docs": [], "catalog_items": []}
+
+    def _worker(self) -> None:
+        while self._running:
+            events: List[Dict[str, Any]] = []
+            while not self._queue.empty() and len(events) < 50:
+                try:
+                    events.append(self._queue.get_nowait())
+                except queue.Empty:
+                    break
+
+            if events:
+                self._flush(events)
+            time.sleep(self.flush_interval)
+
+    def _flush(self, events: List[Dict[str, Any]]) -> None:
+        try:
+            self._client.post(
+                self.endpoint,
+                json={"batch": events},
+                headers={
+                    "Authorization": f"Bearer {self.api_key}",
+                    "Content-Type": "application/json",
+                },
+            )
+        except Exception:
+            pass  # Swallowed silently so it never breaks host server execution
+
+    def flush(self) -> None:
+        """Manually flushes all currently queued events immediately."""
+        events: List[Dict[str, Any]] = []
+        while not self._queue.empty():
+            try:
+                events.append(self._queue.get_nowait())
+            except queue.Empty:
+                break
+        if events:
+            self._flush(events)
+
+    def close(self) -> None:
+        self._running = False
+        self.flush()
+        try:
+            self._worker_thread.join(timeout=2.0)
+            self._client.close()
+        except Exception:
+            pass
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.close()

sannex_agent-0.1.0/sannex_agent/py.typed

@@ -0,0 +1 @@
+# Marker file for PEP 561