"""External plugin interoperability helpers.""" from __future__ import annotations from dataclasses import dataclass, field from typing import Any PRIVATE_COMPANION = "astrbot_plugin_private_companion" ALLOWED_PLUGINS = {PRIVATE_COMPANION} @dataclass(frozen=True) class PluginRequest: plugin_name: str action: str payload: dict[str, Any] = field(default_factory=dict) request_id: str | None = None def to_dict(self) -> dict[str, Any]: return { "plugin_name": self.plugin_name, "action": self.action, "payload": self.payload, "request_id": self.request_id, } def normalize_plugin_request(payload: dict[str, Any]) -> PluginRequest: plugin_name = str(payload.get("plugin_name") or payload.get("request_source") or "").strip() action = str(payload.get("action") or "").strip() if not plugin_name: raise ValueError("plugin_name is required") if not action: raise ValueError("action is required") return PluginRequest( plugin_name=plugin_name, action=action, payload=dict(payload.get("payload") or {}), request_id=payload.get("request_id"), ) def is_allowed_plugin(plugin_name: str, allowed_plugins: set[str] | list[str] | tuple[str, ...] | None = None) -> bool: allowed = set(allowed_plugins or ALLOWED_PLUGINS) return str(plugin_name or "").strip() in allowed def daily_outfit_request(payload: dict[str, Any]) -> PluginRequest: request = normalize_plugin_request( { "plugin_name": payload.get("request_source") or PRIVATE_COMPANION, "action": "daily_outfit", "payload": payload, "request_id": payload.get("request_id"), } ) if not is_allowed_plugin(request.plugin_name): raise ValueError("plugin is not allowed") return request