"""Identity and request actor helpers.""" from __future__ import annotations from dataclasses import dataclass, field from datetime import UTC, datetime from uuid import uuid4 def new_request_id() -> str: return f"req_{uuid4().hex}" @dataclass(frozen=True) class RequestContext: request_id: str = field(default_factory=new_request_id) username: str | None = None user_id: str | None = None client_ip: str | None = None source: str = "system" platform: str = "webui" session_key: str | None = None is_authenticated: bool = False permissions: frozenset[str] = field(default_factory=frozenset) created_at: datetime = field(default_factory=lambda: datetime.now(UTC)) @property def actor_id(self) -> str | None: return self.user_id or self.username @property def actor_type(self) -> str: return "user" if self.actor_id else "system" def has_permission(self, permission: str) -> bool: return permission in self.permissions or "*" in self.permissions @classmethod def system(cls, source: str = "system") -> "RequestContext": return cls( username="system", user_id="system", source=source, is_authenticated=True, permissions=frozenset({"*"}), ) @classmethod def from_astrbot( cls, *, username: str | None, user_id: str | None = None, client_ip: str | None = None, source: str = "standalone", platform: str = "astrbot", session_key: str | None = None, permissions: set[str] | frozenset[str] | None = None, ) -> "RequestContext": return cls( username=username, user_id=user_id, client_ip=client_ip, source=source, platform=platform, session_key=session_key, is_authenticated=bool(username or user_id), permissions=frozenset(permissions or set()), )