fb9fc8a3dd
The Home Assistant gateway platform (plugins/platforms/homeassistant) and the homeassistant toolset (tools/homeassistant_tool.py) now ship as the official catalog plugin `homeassistant` (NousResearch/hermes-homeassistant), with the same platform name, toolset/tool names, config keys and env vars. Migration (hermes_cli/left_core_migration.py, a generic "left core" table reusing the memory-provider migration's helpers): every profile home that used Home Assistant (HASS_TOKEN in its .env, platforms.homeassistant enabled or holding a token, or the homeassistant toolset selected) gets the plugin installed from the catalog at its reviewed pin by `hermes update`, and lazily once per process at agent start / gateway start (honours security.allow_lazy_installs). Every outcome reaches terminal, Desktop and chat; a gateway-start outcome is handed to that home's first agent. Core HA special cases become generic PlatformEntry seams the plugin uses: trusted_inbound (allowlist bypass for event-bus platforms), display_tier (built-in display defaults) and shared_env_prefixes (profile-clone ownership rule for env shared with the plugin's tools). Cron delivery uses the existing cron_deliver_env_var seam; HASS_TOKEN stays stripped from subprocesses via the installed plugin's manifest secrets.
69 lines
3.5 KiB
Python
69 lines
3.5 KiB
Python
"""Shared platform registry for Hermes Agent."""
|
|
|
|
from collections import OrderedDict
|
|
from typing import NamedTuple
|
|
|
|
|
|
class PlatformInfo(NamedTuple):
|
|
"""Metadata for a single platform entry."""
|
|
label: str
|
|
default_toolset: str
|
|
|
|
|
|
# Ordered so that TUI menus are deterministic.
|
|
PLATFORMS: OrderedDict[str, PlatformInfo] = OrderedDict([
|
|
("cli", PlatformInfo(label="🖥️ CLI", default_toolset="hermes-cli")),
|
|
("telegram", PlatformInfo(label="📱 Telegram", default_toolset="hermes-telegram")),
|
|
("discord", PlatformInfo(label="💬 Discord", default_toolset="hermes-discord")),
|
|
("slack", PlatformInfo(label="💼 Slack", default_toolset="hermes-slack")),
|
|
("whatsapp", PlatformInfo(label="📱 WhatsApp", default_toolset="hermes-whatsapp")),
|
|
("whatsapp_cloud", PlatformInfo(label="📱 WhatsApp Business (Cloud)", default_toolset="hermes-whatsapp")),
|
|
("signal", PlatformInfo(label="📡 Signal", default_toolset="hermes-signal")),
|
|
("bluebubbles", PlatformInfo(label="💙 BlueBubbles", default_toolset="hermes-bluebubbles")),
|
|
("email", PlatformInfo(label="📧 Email", default_toolset="hermes-email")),
|
|
("mattermost", PlatformInfo(label="💬 Mattermost", default_toolset="hermes-mattermost")),
|
|
("matrix", PlatformInfo(label="💬 Matrix", default_toolset="hermes-matrix")),
|
|
("dingtalk", PlatformInfo(label="💬 DingTalk", default_toolset="hermes-dingtalk")),
|
|
("feishu", PlatformInfo(label="🪽 Feishu", default_toolset="hermes-feishu")),
|
|
("wecom", PlatformInfo(label="💬 WeCom", default_toolset="hermes-wecom")),
|
|
("wecom_callback", PlatformInfo(label="💬 WeCom Callback", default_toolset="hermes-wecom-callback")),
|
|
("weixin", PlatformInfo(label="💬 Weixin", default_toolset="hermes-weixin")),
|
|
("qqbot", PlatformInfo(label="💬 QQBot", default_toolset="hermes-qqbot")),
|
|
("yuanbao", PlatformInfo(label="🤖 Yuanbao", default_toolset="hermes-yuanbao")),
|
|
("webhook", PlatformInfo(label="🔗 Webhook", default_toolset="hermes-webhook")),
|
|
("api_server", PlatformInfo(label="🌐 API Server", default_toolset="hermes-api-server")),
|
|
("cron", PlatformInfo(label="⏰ Cron", default_toolset="hermes-cron")),
|
|
])
|
|
|
|
|
|
def _plugin_label(entry) -> str:
|
|
return f"{entry.emoji} {entry.label}" if entry.emoji else entry.label
|
|
|
|
|
|
def platform_label(key: str, default: str = "") -> str:
|
|
"""Return the display label for a platform key (builtin, then plugin registry), or *default*."""
|
|
info = PLATFORMS.get(key)
|
|
if info is not None:
|
|
return info.label
|
|
try:
|
|
from gateway.platform_registry import platform_registry
|
|
entry = platform_registry.get(key)
|
|
if entry:
|
|
return _plugin_label(entry)
|
|
except Exception:
|
|
pass
|
|
return default
|
|
|
|
|
|
def get_all_platforms() -> "OrderedDict[str, PlatformInfo]":
|
|
"""PLATFORMS plus plugin-registered platforms (appended after builtins) — use for menus."""
|
|
merged = OrderedDict(PLATFORMS)
|
|
try:
|
|
from gateway.platform_registry import platform_registry
|
|
for entry in platform_registry.plugin_entries():
|
|
if entry.name not in merged:
|
|
merged[entry.name] = PlatformInfo(_plugin_label(entry), f"hermes-{entry.name}")
|
|
except Exception:
|
|
pass
|
|
return merged
|