"""Abstract persistence API for custom agents.""" from __future__ import annotations from abc import ABC, abstractmethod from typing import Any class AgentStore(ABC): @abstractmethod async def list_visible(self, user_id: str) -> list[dict[str, Any]]: raise NotImplementedError @abstractmethod async def get_visible(self, agent_id: str, user_id: str) -> dict[str, Any] | None: raise NotImplementedError @abstractmethod async def get_any(self, agent_id: str) -> dict[str, Any] | None: raise NotImplementedError @abstractmethod async def get_owned(self, agent_id: str, user_id: str) -> dict[str, Any] | None: raise NotImplementedError @abstractmethod async def create(self, data: dict[str, Any]) -> dict[str, Any]: raise NotImplementedError @abstractmethod async def ensure_builtin(self, data: dict[str, Any]) -> dict[str, Any]: raise NotImplementedError @abstractmethod async def update(self, agent_id: str, user_id: str, data: dict[str, Any]) -> dict[str, Any] | None: raise NotImplementedError @abstractmethod async def delete(self, agent_id: str, user_id: str) -> bool: raise NotImplementedError