raredaysai 0.1.0__tar.gz

raredaysai-0.1.0/.gitignore

@@ -0,0 +1,80 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files (can opt-in for committing if needed)
+.env*
+!.env.example
+
+# sst
+.sst/
+sst-env.d.ts
+sst.pyi
+
+# opennext
+.open-next/
+
+# uv (python reranker)
+uv.lock
+
+# pdf data
+/pdfs/
+
+# evaluation results
+/eval-results/
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts
+pdfs-full/
+.deploy-config.json
+
+# transcript usefulness identifier
+gen_report.output
+gen_report.py
+transcript_assessment.txt
+transcript_assessment_final.txt
+transcript_groups.txt
+transcript_hashes.txt
+transcript_unique_groups.txt
+
+# Monorepo
+packages/*/node_modules
+packages/*/.next
+packages/*/dist
+packages/*/.env.local
+.turbo
+
+# Local planning (superpowers)
+docs/superpowers/

raredaysai-0.1.0/PKG-INFO

@@ -0,0 +1,11 @@
+Metadata-Version: 2.4
+Name: raredaysai
+Version: 0.1.0
+Summary: RareDaysAI Python SDK — RAG chatbot platform client
+License-Expression: MIT
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.27
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: respx>=0.22; extra == 'dev'

raredaysai-0.1.0/README.md

@@ -0,0 +1,32 @@
+# raredaysai
+
+Python SDK for [RareDaysAI](https://raredays.ai) — RAG chatbot platform.
+
+## Install
+
+```bash
+pip install raredaysai
+```
+
+## Usage
+
+```python
+from raredaysai import RareDaysClient
+
+client = RareDaysClient(secret_key="sk_live_xxx")
+
+# Chat
+response = client.chat.send("What activities help with dementia?")
+print(response.text)
+
+# Sessions (for frontend auth)
+session = client.sessions.create("user_123")
+print(session.token)
+
+# Config
+client.config.push({"identity": "You are a helpful bot", "rules": ["Be kind"]})
+
+# Sync content
+result = client.connectors.sync("cms")
+print(f"Synced: {result.new_docs} new, {result.updated_docs} updated")
+```

raredaysai-0.1.0/pyproject.toml

@@ -0,0 +1,14 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "raredaysai"
+version = "0.1.0"
+description = "RareDaysAI Python SDK — RAG chatbot platform client"
+requires-python = ">=3.9"
+license = "MIT"
+dependencies = ["httpx>=0.27"]
+
+[project.optional-dependencies]
+dev = ["pytest>=8", "pytest-asyncio>=0.24", "respx>=0.22"]

raredaysai-0.1.0/raredaysai/__init__.py

@@ -0,0 +1,9 @@
+from .client import RareDaysClient, AsyncRareDaysClient
+from .exceptions import RareDaysError
+from .types import ChatResponse, Citation, SessionResponse, ConfigPushResponse, ConfigPullResponse, SyncResult
+
+__all__ = [
+    "RareDaysClient", "AsyncRareDaysClient", "RareDaysError",
+    "ChatResponse", "Citation", "SessionResponse",
+    "ConfigPushResponse", "ConfigPullResponse", "SyncResult",
+]

raredaysai-0.1.0/raredaysai/client.py

@@ -0,0 +1,163 @@
+from __future__ import annotations
+from typing import Optional
+import httpx
+from .types import ChatResponse, Citation, SessionResponse, ConfigPushResponse, ConfigPullResponse, SyncResult
+from .exceptions import RareDaysError
+
+
+class _ChatNamespace:
+    def __init__(self, client: _BaseClient):
+        self._client = client
+
+    def send(self, message: str, conversation_id: Optional[str] = None) -> ChatResponse:
+        data = {"messages": [{"role": "user", "content": message}]}
+        if conversation_id:
+            data["conversationId"] = conversation_id
+        resp = self._client._request("POST", "/v1/chat/sync", json=data)
+        return ChatResponse(
+            text=resp["text"],
+            conversation_id=resp.get("conversationId"),
+            citations=[Citation(**c) for c in resp.get("citations", [])],
+        )
+
+
+class _SessionsNamespace:
+    def __init__(self, client: _BaseClient):
+        self._client = client
+
+    def create(self, user_id: str, metadata: Optional[dict] = None, expires_in: Optional[str] = None) -> SessionResponse:
+        data: dict = {"userId": user_id}
+        if metadata:
+            data["metadata"] = metadata
+        if expires_in:
+            data["expiresIn"] = expires_in
+        resp = self._client._request("POST", "/v1/sessions", json=data)
+        return SessionResponse(token=resp["token"], expires_at=resp["expiresAt"])
+
+
+class _ConfigNamespace:
+    def __init__(self, client: _BaseClient):
+        self._client = client
+
+    def push(self, config: dict) -> ConfigPushResponse:
+        resp = self._client._request("POST", "/v1/config/push", json={"config": config})
+        return ConfigPushResponse(version=resp["version"], pushed_at=resp["pushedAt"])
+
+    def pull(self) -> ConfigPullResponse:
+        resp = self._client._request("GET", "/v1/config/pull")
+        return ConfigPullResponse(config=resp["config"], version=resp["version"], pushed_at=resp["pushedAt"])
+
+
+class _IngestNamespace:
+    def __init__(self, client: _BaseClient):
+        self._client = client
+
+    def upload(self, document_id: str, title: str, content: str, source_type: str = "api", metadata: Optional[dict] = None) -> dict:
+        data = {"documentId": document_id, "title": title, "content": content, "sourceType": source_type}
+        if metadata:
+            data["metadata"] = metadata
+        return self._client._request("POST", "/v1/ingest", json=data)
+
+    def delete(self, document_id: str) -> None:
+        self._client._request("DELETE", f"/v1/ingest/{document_id}")
+
+
+class _ConnectorsNamespace:
+    def __init__(self, client: _BaseClient):
+        self._client = client
+
+    def sync(self, connector_id: str) -> SyncResult:
+        resp = self._client._request("POST", f"/v1/connectors/{connector_id}/sync")
+        r = resp["result"]
+        return SyncResult(
+            new_docs=r["newDocs"], updated_docs=r["updatedDocs"],
+            deleted_docs=r["deletedDocs"], skipped_docs=r["skippedDocs"],
+            failed_docs=r["failedDocs"], duration_ms=r["durationMs"],
+            errors=r.get("errors", []),
+        )
+
+    def status(self) -> list[dict]:
+        resp = self._client._request("GET", "/v1/connectors")
+        return resp["connectors"]
+
+
+class _BaseClient:
+    def __init__(self, secret_key: Optional[str] = None, session_token: Optional[str] = None, base_url: str = "https://api.raredays.ai"):
+        if not secret_key and not session_token:
+            raise ValueError("secret_key or session_token is required")
+        self._token = secret_key or session_token
+        self._base_url = base_url.rstrip("/")
+        self._http = httpx.Client(
+            base_url=self._base_url,
+            headers={"Authorization": f"Bearer {self._token}", "Content-Type": "application/json"},
+            timeout=60,
+        )
+        self.chat = _ChatNamespace(self)
+        self.sessions = _SessionsNamespace(self)
+        self.config = _ConfigNamespace(self)
+        self.ingest = _IngestNamespace(self)
+        self.connectors = _ConnectorsNamespace(self)
+
+    def _request(self, method: str, path: str, **kwargs) -> dict:
+        resp = self._http.request(method, path, **kwargs)
+        if resp.status_code >= 400:
+            try:
+                body = resp.json()
+                error = body.get("error", {})
+                raise RareDaysError(error.get("code", "unknown"), error.get("message", resp.text), resp.status_code)
+            except (ValueError, KeyError):
+                raise RareDaysError("unknown", resp.text, resp.status_code)
+        if resp.status_code == 204:
+            return {}
+        return resp.json()
+
+    def close(self):
+        self._http.close()
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *args):
+        self.close()
+
+
+class RareDaysClient(_BaseClient):
+    """Synchronous RareDaysAI client."""
+    pass
+
+
+class AsyncRareDaysClient:
+    """Async RareDaysAI client using httpx.AsyncClient."""
+
+    def __init__(self, secret_key: Optional[str] = None, session_token: Optional[str] = None, base_url: str = "https://api.raredays.ai"):
+        if not secret_key and not session_token:
+            raise ValueError("secret_key or session_token is required")
+        self._token = secret_key or session_token
+        self._base_url = base_url.rstrip("/")
+        self._http = httpx.AsyncClient(
+            base_url=self._base_url,
+            headers={"Authorization": f"Bearer {self._token}", "Content-Type": "application/json"},
+            timeout=60,
+        )
+
+    async def _request(self, method: str, path: str, **kwargs) -> dict:
+        resp = await self._http.request(method, path, **kwargs)
+        if resp.status_code >= 400:
+            try:
+                body = resp.json()
+                error = body.get("error", {})
+                raise RareDaysError(error.get("code", "unknown"), error.get("message", resp.text), resp.status_code)
+            except (ValueError, KeyError):
+                raise RareDaysError("unknown", resp.text, resp.status_code)
+        if resp.status_code == 204:
+            return {}
+        return resp.json()
+
+    async def close(self):
+        await self._http.aclose()
+
+    async def __aenter__(self):
+        return self
+
+    async def __aexit__(self, *args):
+        await self.close()

raredaysai-0.1.0/raredaysai/exceptions.py

@@ -0,0 +1,5 @@
+class RareDaysError(Exception):
+    def __init__(self, code: str, message: str, status: int):
+        super().__init__(message)
+        self.code = code
+        self.status = status

raredaysai-0.1.0/raredaysai/types.py

@@ -0,0 +1,49 @@
+from __future__ import annotations
+from dataclasses import dataclass, field
+from typing import Optional
+
+
+@dataclass
+class Citation:
+    index: int
+    title: str
+    section: Optional[str] = None
+    page: Optional[int] = None
+
+
+@dataclass
+class ChatResponse:
+    text: str
+    conversation_id: Optional[str] = None
+    citations: list[Citation] = field(default_factory=list)
+
+
+@dataclass
+class SessionResponse:
+    token: str
+    expires_at: str
+
+
+
+@dataclass
+class ConfigPushResponse:
+    version: int
+    pushed_at: str
+
+
+@dataclass
+class ConfigPullResponse:
+    config: dict
+    version: int
+    pushed_at: str
+
+
+@dataclass
+class SyncResult:
+    new_docs: int
+    updated_docs: int
+    deleted_docs: int
+    skipped_docs: int
+    failed_docs: int
+    duration_ms: int
+    errors: list[dict] = field(default_factory=list)

raredaysai-0.1.0/tests/conftest.py

@@ -0,0 +1,8 @@
+import pytest
+
+
+@pytest.fixture
+def respx_mock():
+    import respx
+    with respx.mock:
+        yield respx.mock

raredaysai-0.1.0/tests/test_client.py

@@ -0,0 +1,82 @@
+import pytest
+import httpx
+from raredaysai import RareDaysClient, RareDaysError, ChatResponse, SessionResponse
+
+
+def test_requires_auth():
+    with pytest.raises(ValueError, match="secret_key or session_token"):
+        RareDaysClient()
+
+
+def test_chat_send(respx_mock):
+    respx_mock.post("https://api.raredays.ai/v1/chat/sync").mock(
+        return_value=httpx.Response(200, json={
+            "text": "Hello world",
+            "conversationId": "conv_123",
+            "citations": [{"index": 1, "title": "Doc A"}],
+        })
+    )
+    client = RareDaysClient(secret_key="sk_test_xxx")
+    resp = client.chat.send("Hi")
+    assert isinstance(resp, ChatResponse)
+    assert resp.text == "Hello world"
+    assert resp.conversation_id == "conv_123"
+    assert len(resp.citations) == 1
+
+
+def test_session_create(respx_mock):
+    respx_mock.post("https://api.raredays.ai/v1/sessions").mock(
+        return_value=httpx.Response(200, json={"token": "jwt_xxx", "expiresAt": "2026-05-25T00:00:00Z"})
+    )
+    client = RareDaysClient(secret_key="sk_test_xxx")
+    resp = client.sessions.create("user_123")
+    assert isinstance(resp, SessionResponse)
+    assert resp.token == "jwt_xxx"
+
+
+def test_config_push(respx_mock):
+    respx_mock.post("https://api.raredays.ai/v1/config/push").mock(
+        return_value=httpx.Response(200, json={"version": 1, "pushedAt": "2026-05-25T00:00:00Z"})
+    )
+    client = RareDaysClient(secret_key="sk_test_xxx")
+    resp = client.config.push({"identity": "Test"})
+    assert resp.version == 1
+
+
+def test_config_pull(respx_mock):
+    respx_mock.get("https://api.raredays.ai/v1/config/pull").mock(
+        return_value=httpx.Response(200, json={"config": {"identity": "Test"}, "version": 2, "pushedAt": "2026-05-25T00:00:00Z"})
+    )
+    client = RareDaysClient(secret_key="sk_test_xxx")
+    resp = client.config.pull()
+    assert resp.config["identity"] == "Test"
+
+
+def test_error_handling(respx_mock):
+    respx_mock.post("https://api.raredays.ai/v1/chat/sync").mock(
+        return_value=httpx.Response(401, json={"error": {"code": "unauthorized", "message": "Invalid key"}})
+    )
+    client = RareDaysClient(secret_key="sk_bad")
+    with pytest.raises(RareDaysError) as exc:
+        client.chat.send("Hi")
+    assert exc.value.status == 401
+    assert exc.value.code == "unauthorized"
+
+
+def test_connector_sync(respx_mock):
+    respx_mock.post("https://api.raredays.ai/v1/connectors/cms/sync").mock(
+        return_value=httpx.Response(200, json={"result": {
+            "newDocs": 2, "updatedDocs": 1, "deletedDocs": 0,
+            "skippedDocs": 5, "failedDocs": 0, "durationMs": 3500, "errors": [],
+        }})
+    )
+    client = RareDaysClient(secret_key="sk_test_xxx")
+    result = client.connectors.sync("cms")
+    assert result.new_docs == 2
+    assert result.duration_ms == 3500
+
+
+def test_context_manager():
+    client = RareDaysClient(secret_key="sk_test_xxx")
+    with client as c:
+        assert c is client