243 lines
9.8 KiB
Python
243 lines
9.8 KiB
Python
"""Async clients for OpenViking and EverOS used by the lightweight API."""
|
|
from __future__ import annotations
|
|
|
|
from dataclasses import dataclass
|
|
from datetime import datetime, timezone
|
|
from typing import Any
|
|
|
|
import httpx
|
|
|
|
from .config import get_config
|
|
from .store import OpenVikingUserKeyStore
|
|
|
|
|
|
@dataclass(frozen=True)
|
|
class OpenVikingCredential:
|
|
api_key: str
|
|
account_id: str | None = None
|
|
user_id: str | None = None
|
|
|
|
|
|
class OpenVikingMemorySystemClient:
|
|
def __init__(self, store: OpenVikingUserKeyStore | None = None) -> None:
|
|
config = get_config()
|
|
self.base_url = config.openviking.url.rstrip("/")
|
|
self.root_key = config.openviking.api_key or "your-secret-root-key"
|
|
self.timeout = config.openviking.timeout
|
|
self.verify_ssl = config.openviking.verify_ssl
|
|
self.store = store or OpenVikingUserKeyStore(config.storage.sqlite_path)
|
|
|
|
async def health(self) -> dict[str, Any]:
|
|
async with self._client(self.root_key) as client:
|
|
response = await client.get("/health")
|
|
response.raise_for_status()
|
|
return response.json()
|
|
|
|
async def ensure_user(self, user_id: str) -> OpenVikingCredential:
|
|
existing = self.store.get_user_key(user_id)
|
|
if existing:
|
|
return OpenVikingCredential(api_key=existing)
|
|
|
|
async with self._client(self.root_key) as client:
|
|
response = await client.post(
|
|
"/api/v1/admin/accounts",
|
|
json={"account_id": user_id, "admin_user_id": user_id},
|
|
)
|
|
if response.status_code == 409:
|
|
return self.root_credential(user_id)
|
|
response.raise_for_status()
|
|
data = response.json()
|
|
|
|
user_key = self._extract_user_key(data)
|
|
if not user_key:
|
|
return self.root_credential(user_id)
|
|
self.store.save_user_key(user_id, user_key)
|
|
return OpenVikingCredential(api_key=user_key)
|
|
|
|
def root_credential(self, user_id: str) -> OpenVikingCredential:
|
|
return OpenVikingCredential(api_key=self.root_key, account_id=user_id, user_id=user_id)
|
|
|
|
async def ensure_session(self, credential: OpenVikingCredential | str, session_id: str) -> dict[str, Any]:
|
|
async with self._credential_client(credential) as client:
|
|
response = await client.post("/api/v1/sessions", json={"session_id": session_id})
|
|
if response.status_code in {409, 422}:
|
|
return {"session_id": session_id, "status": "exists"}
|
|
response.raise_for_status()
|
|
return response.json()
|
|
|
|
async def append_message(
|
|
self, credential: OpenVikingCredential | str, session_id: str, role: str, content: str
|
|
) -> dict[str, Any]:
|
|
async with self._credential_client(credential) as client:
|
|
response = await client.post(
|
|
f"/api/v1/sessions/{session_id}/messages",
|
|
json={"role": role, "content": content},
|
|
)
|
|
response.raise_for_status()
|
|
return response.json()
|
|
|
|
async def commit_session(self, credential: OpenVikingCredential | str, session_id: str) -> dict[str, Any]:
|
|
async with self._credential_client(credential) as client:
|
|
response = await client.post(f"/api/v1/sessions/{session_id}/commit")
|
|
response.raise_for_status()
|
|
return response.json()
|
|
|
|
async def extract_session(self, credential: OpenVikingCredential | str, session_id: str) -> dict[str, Any]:
|
|
async with self._credential_client(credential) as client:
|
|
response = await client.post(f"/api/v1/sessions/{session_id}/extract")
|
|
response.raise_for_status()
|
|
return response.json()
|
|
|
|
async def get_task(self, credential: OpenVikingCredential | str, task_id: str) -> dict[str, Any]:
|
|
async with self._credential_client(credential) as client:
|
|
response = await client.get(f"/api/v1/tasks/{task_id}")
|
|
response.raise_for_status()
|
|
return response.json()
|
|
|
|
async def find(
|
|
self, credential: OpenVikingCredential | str, user_id: str, query: str, limit: int
|
|
) -> dict[str, Any]:
|
|
async with self._credential_client(credential) as client:
|
|
response = await client.post(
|
|
"/api/v1/search/find",
|
|
json={
|
|
"query": query,
|
|
"target_uri": f"viking://user/{user_id}/memories/",
|
|
"limit": limit,
|
|
},
|
|
)
|
|
response.raise_for_status()
|
|
return response.json()
|
|
|
|
async def search(
|
|
self, credential: OpenVikingCredential | str, session_id: str | None, query: str, limit: int
|
|
) -> dict[str, Any]:
|
|
payload: dict[str, Any] = {"query": query, "limit": limit}
|
|
if session_id:
|
|
payload["session_id"] = session_id
|
|
async with self._credential_client(credential) as client:
|
|
response = await client.post("/api/v1/search/search", json=payload)
|
|
response.raise_for_status()
|
|
return response.json()
|
|
|
|
def _credential_client(self, credential: OpenVikingCredential | str) -> httpx.AsyncClient:
|
|
if isinstance(credential, str):
|
|
return self._client(credential)
|
|
headers = {}
|
|
if credential.account_id:
|
|
headers["X-OpenViking-Account"] = credential.account_id
|
|
if credential.user_id:
|
|
headers["X-OpenViking-User"] = credential.user_id
|
|
return self._client(credential.api_key, headers)
|
|
|
|
def _client(self, api_key: str, extra_headers: dict[str, str] | None = None) -> httpx.AsyncClient:
|
|
headers = {"X-API-Key": api_key, "Content-Type": "application/json"}
|
|
if extra_headers:
|
|
headers.update(extra_headers)
|
|
return httpx.AsyncClient(
|
|
base_url=self.base_url,
|
|
headers=headers,
|
|
timeout=self.timeout,
|
|
verify=self.verify_ssl,
|
|
)
|
|
|
|
def _extract_user_key(self, data: dict[str, Any]) -> str | None:
|
|
result = data.get("result") if isinstance(data.get("result"), dict) else data
|
|
value = result.get("user_key") if isinstance(result, dict) else None
|
|
return str(value) if value else None
|
|
|
|
|
|
class EverOSMemorySystemClient:
|
|
def __init__(self) -> None:
|
|
config = get_config()
|
|
self.base_url = config.everos.url.rstrip("/")
|
|
self.api_key = config.everos.api_key
|
|
self.timeout = config.everos.timeout
|
|
self.verify_ssl = config.everos.verify_ssl
|
|
self.health_path = config.everos.health_path
|
|
|
|
async def health(self) -> dict[str, Any]:
|
|
async with self._client() as client:
|
|
response = await client.get(self.health_path)
|
|
response.raise_for_status()
|
|
return response.json()
|
|
|
|
async def append_message(self, user_id: str, session_id: str, role: str, content: str) -> dict[str, Any]:
|
|
async with self._client() as client:
|
|
response = await client.post(
|
|
"/api/v1/memories",
|
|
json=self.build_message_payload(user_id=user_id, session_id=session_id, role=role, content=content),
|
|
)
|
|
response.raise_for_status()
|
|
return response.json()
|
|
|
|
def build_message_payload(self, user_id: str, session_id: str, role: str, content: str) -> dict[str, Any]:
|
|
everos_role = "assistant" if role == "assistant" else "user"
|
|
sender_id = "assistant" if everos_role == "assistant" else user_id
|
|
timestamp = int(datetime.now(timezone.utc).timestamp() * 1000)
|
|
return {
|
|
"user_id": user_id,
|
|
"session_id": session_id,
|
|
"messages": [
|
|
{
|
|
"message_id": f"msg_{timestamp}",
|
|
"timestamp": timestamp,
|
|
"sender_id": sender_id,
|
|
"sender_name": sender_id,
|
|
"role": everos_role,
|
|
"content": content,
|
|
}
|
|
],
|
|
}
|
|
|
|
async def flush(self, user_id: str, session_id: str) -> dict[str, Any]:
|
|
async with self._client() as client:
|
|
response = await client.post("/api/v1/memories/flush", json={"user_id": user_id, "session_id": session_id})
|
|
response.raise_for_status()
|
|
return response.json()
|
|
|
|
async def search(self, user_id: str, session_id: str | None, query: str, method: str, limit: int) -> dict[str, Any]:
|
|
filters: dict[str, Any] = {"user_id": user_id}
|
|
if session_id:
|
|
filters["session_id"] = session_id
|
|
async with self._client() as client:
|
|
response = await client.post(
|
|
"/api/v1/memories/search",
|
|
json={
|
|
"query": query,
|
|
"method": method,
|
|
"memory_types": ["episodic_memory", "profile", "raw_message"],
|
|
"filters": filters,
|
|
"top_k": limit,
|
|
"include_original_data": True,
|
|
},
|
|
)
|
|
response.raise_for_status()
|
|
return response.json()
|
|
|
|
async def get_profile(self, user_id: str) -> dict[str, Any]:
|
|
async with self._client() as client:
|
|
response = await client.post(
|
|
"/api/v1/memories/get",
|
|
json={
|
|
"memory_type": "profile",
|
|
"filters": {"user_id": user_id},
|
|
"page": 1,
|
|
"page_size": 20,
|
|
},
|
|
)
|
|
response.raise_for_status()
|
|
return response.json()
|
|
|
|
def _client(self) -> httpx.AsyncClient:
|
|
headers = {"Content-Type": "application/json"}
|
|
if self.api_key:
|
|
headers["X-API-Key"] = self.api_key
|
|
headers["Authorization"] = f"Bearer {self.api_key}"
|
|
return httpx.AsyncClient(
|
|
base_url=self.base_url,
|
|
headers=headers,
|
|
timeout=self.timeout,
|
|
verify=self.verify_ssl,
|
|
)
|