Agent Zero
52 lines
1.3 KiB
Python
52 lines
1.3 KiB
Python
"""Public contract for the mail plugin.
|
|
|
|
Exposes only the symbols that other builtins plugins need.
|
|
Currently the only cross-plugin consumer is ai_proactive, which imports
|
|
the ``Mail`` model for querying recent emails by contact.
|
|
|
|
Importers should use::
|
|
|
|
from app.plugins.builtins.contracts import get_contract
|
|
mail = get_contract("mail")
|
|
if mail:
|
|
result = await db.execute(select(mail.Mail).where(...))
|
|
|
|
instead of importing from internal modules directly.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from app.plugins.builtins.contracts import get_contract_registry
|
|
from app.plugins.builtins.mail.models import Mail, MailAccount
|
|
|
|
|
|
class MailContract:
|
|
"""Public API surface for the mail plugin.
|
|
|
|
Exposes ORM models so that other plugins can query the mail tables
|
|
without importing from ``mail.models`` directly.
|
|
"""
|
|
|
|
contract_name = "mail"
|
|
|
|
# ─── models ───
|
|
Mail = Mail
|
|
MailAccount = MailAccount
|
|
|
|
@classmethod
|
|
def get_function(cls, name: str):
|
|
"""Return a callable exposed by this contract, or None if absent."""
|
|
return getattr(cls, name, None)
|
|
|
|
|
|
# ─── self-registration ───
|
|
|
|
_contract = MailContract()
|
|
get_contract_registry().register("mail", _contract)
|
|
|
|
|
|
__all__ = [
|
|
"MailContract",
|
|
"Mail",
|
|
]
|