Make your computer a home for your AI partner. Avibe is the local-first Agent OS: Vibey, its built-in AI partner, works out of the box, and Claude Code, Codex & OpenCode run unchanged beside it — reach them from your browser, phone, or any chat app.
Python agentagent-osaiai-agentsai-partnerchatopsclaudeclaude-codecodexdevtoolsdiscord-botlark-botllmlocal-firstlong-term-memoryopencodeslack-botvibe-codingvibeywechat
"""Shared delivery for plain-text administrator notifications."""
from __future__ import annotations
import logging
from collections.abc import Iterable, Mapping
from typing import Any, Protocol
from config.v2_settings import _infer_user_platform, _split_scoped_key
logger = logging.getLogger(__name__)
class AdminNotificationClient(Protocol):
async def send_dm(self, user_id: str, text: str, **kwargs: Any) -> object: ...
class AdminNotificationController(Protocol):
im_clients: Mapping[str, AdminNotificationClient]
im_client: AdminNotificationClient
primary_platform: str
def resolve_admin_target(
controller: AdminNotificationController,
user_id: object,
) -> tuple[str, str]:
"""Resolve a scoped admin id, preserving legacy primary-platform users."""
scoped_platform, raw_user_id = _split_scoped_key(str(user_id))
platform = scoped_platform or _infer_user_platform(raw_user_id)
if platform != "unknown":
return platform, raw_user_id
primary_platform = str(getattr(controller, "primary_platform", "") or "").strip()
if not primary_platform:
primary_platform = str(getattr(getattr(controller, "im_client", None), "primary_platform", "") or "").strip()
return primary_platform or platform, raw_user_id
def delivery_succeeded(result: object) -> bool:
if result is None:
return False
if isinstance(result, bool):
return result
if isinstance(result, dict) and "ok" in result:
return bool(result["ok"])
return True
async def send_admin_text(
controller: AdminNotificationController,
admin_ids: Iterable[object],
text: str,
*,
log_label: str,
) -> set[str]:
"""Send one inert text notification to configured admins across transports."""
delivered_platforms: set[str] = set()
for user_id in admin_ids:
platform, raw_user_id = resolve_admin_target(controller, user_id)
client = controller.im_clients.get(platform)
if client is None and platform == "unknown":
client = getattr(controller, "im_client", None)
if client is None:
logger.info("Skipped %s for admin %s because %s is disabled", log_label, user_id, platform)
continue
try:
result = await client.send_dm(raw_user_id, text)
if delivery_succeeded(result):
delivered_platforms.add(platform)
logger.info("Sent %s to admin %s", log_label, user_id)
except Exception as exc:
logger.error("Failed to send %s to admin %s: %s", log_label, user_id, exc)
return delivered_platforms