mirror of
https://github.com/agentscope-ai/ReMe.git
synced 2026-09-15 23:31:05 +00:00
1be61b1e4c
* feat(integrations): add dual-mode Hermes memory provider * style(integrations): apply repository formatting * fix(integrations): address Hermes provider review * fix(integrations): bound embedded recall startup cleanup * fix(integrations): finish embedded application cleanup * docs(integrations): expand Hermes verification guide
45 lines
1.5 KiB
Python
45 lines
1.5 KiB
Python
"""Transport-independent backend contract for the Hermes provider."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from typing import Any, Protocol
|
|
|
|
|
|
class ReMeBackendError(RuntimeError):
|
|
"""Raised when a ReMe backend cannot complete an operation."""
|
|
|
|
|
|
class ReMeBackend(Protocol):
|
|
"""Synchronous interface matching Hermes' memory-provider lifecycle."""
|
|
|
|
label: str
|
|
|
|
def start(self, *, deadline: float | None = None) -> None:
|
|
"""Start owned resources before an optional absolute deadline."""
|
|
|
|
def health(self, *, timeout: float) -> dict[str, Any]:
|
|
"""Return a semantically healthy ReMe response."""
|
|
|
|
def search(self, query: str, *, limit: int, timeout: float) -> dict[str, Any]:
|
|
"""Search the configured ReMe workspace."""
|
|
|
|
def auto_memory(
|
|
self,
|
|
session_id: str,
|
|
messages: list[dict[str, Any]],
|
|
*,
|
|
timeout: float,
|
|
) -> dict[str, Any]:
|
|
"""Record and extract memory from one completed turn."""
|
|
|
|
def close(self, *, timeout: float) -> None:
|
|
"""Release resources within a bounded interval."""
|
|
|
|
|
|
def require_healthy(response: dict[str, Any]) -> dict[str, Any]:
|
|
"""Validate the semantic health flag in a successful ReMe response."""
|
|
metadata = response.get("metadata")
|
|
health = metadata.get("health") if isinstance(metadata, dict) else None
|
|
if not isinstance(health, dict) or health.get("healthy") is not True:
|
|
raise ReMeBackendError("ReMe did not report a healthy component snapshot")
|
|
return response
|