51 lines
1.2 KiB
Python
51 lines
1.2 KiB
Python
"""Abstract base class for agent plugins."""
|
|
|
|
from __future__ import annotations
|
|
|
|
import sys
|
|
from abc import ABC, abstractmethod
|
|
from typing import Any, Dict
|
|
|
|
if sys.version_info >= (3, 11):
|
|
from typing import TypedDict
|
|
else:
|
|
from typing_extensions import TypedDict
|
|
|
|
|
|
class InstallConfig(TypedDict, total=False):
|
|
org_id: str
|
|
agent_id: str
|
|
agent_name: str
|
|
private_key: str
|
|
kid: str
|
|
token: str
|
|
base_url: str
|
|
guard_script_path: str
|
|
|
|
|
|
class PluginStatus(TypedDict):
|
|
installed: bool
|
|
agent: str
|
|
details: str
|
|
|
|
|
|
class AgentPlugin(ABC):
|
|
"""Base class for all agent plugins."""
|
|
|
|
manages_guard_runtime = False
|
|
|
|
def preflight_install(self, config: InstallConfig) -> None:
|
|
"""Validate provider sources before the CLI creates runtime files."""
|
|
|
|
@abstractmethod
|
|
def install(self, config: InstallConfig) -> None:
|
|
"""Install the Elydora hook for this agent."""
|
|
|
|
@abstractmethod
|
|
def uninstall(self, agent_id: str = "") -> None:
|
|
"""Remove the Elydora hook for this agent."""
|
|
|
|
@abstractmethod
|
|
def status(self) -> PluginStatus:
|
|
"""Check whether the Elydora hook is installed for this agent."""
|