mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-05-01 16:31:56 +08:00
2e20f6ae2d
Extends the platform plugin interface from Phase 1 to cover every touchpoint where built-in platforms have hardcoded behavior. - allowed_users_env / allow_all_env: per-platform auth env vars - max_message_length: smart-chunking for send_message tool - pii_safe: session PII redaction flag - emoji: CLI/gateway display - allow_update_command: /update access control send_message tool (tools/send_message_tool.py): - Replaced hardcoded platform_map dict with Platform() call - Added _send_via_adapter() for plugin platforms — routes through live gateway adapter when available - Registry-aware max message length for smart chunking Cron delivery (cron/scheduler.py): - Replaced hardcoded 15-entry platform_map with Platform() call - Plugin platforms now work as cron delivery targets User authorization (gateway/run.py _is_user_authorized): - Registry fallback: checks PlatformEntry.allowed_users_env and allow_all_env when platform not in hardcoded maps - Plugin platforms get per-platform auth support _UPDATE_ALLOWED_PLATFORMS: checks registry allow_update_command flag Channel directory: includes plugin platforms in session enumeration Orphaned config warning: descriptive message when plugin platform is in config but no plugin registered it Gateway weakref: _gateway_runner_ref for cross-module adapter access hermes status: shows plugin platforms with (plugin) tag hermes gateway setup: plugin platforms appear in menu with setup hints hermes_cli/platforms.py: get_all_platforms() merges with registry, platform_label() falls back to registry for plugin names - 8 new tests (extended fields, cron resolution, platforms merge) - Updated 3 tests for new Platform() based resolution - 2829 passed, 24 pre-existing failures, zero new failures
84 lines
4.0 KiB
Python
84 lines
4.0 KiB
Python
"""
|
|
Shared platform registry for Hermes Agent.
|
|
|
|
Single source of truth for platform metadata consumed by both
|
|
skills_config (label display) and tools_config (default toolset
|
|
resolution). Import ``PLATFORMS`` from here instead of maintaining
|
|
duplicate dicts in each module.
|
|
"""
|
|
|
|
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")),
|
|
("signal", PlatformInfo(label="📡 Signal", default_toolset="hermes-signal")),
|
|
("bluebubbles", PlatformInfo(label="💙 BlueBubbles", default_toolset="hermes-bluebubbles")),
|
|
("email", PlatformInfo(label="📧 Email", default_toolset="hermes-email")),
|
|
("homeassistant", PlatformInfo(label="🏠 Home Assistant", default_toolset="hermes-homeassistant")),
|
|
("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 platform_label(key: str, default: str = "") -> str:
|
|
"""Return the display label for a platform key, or *default*.
|
|
|
|
Checks the static PLATFORMS dict first, then the plugin platform
|
|
registry for dynamically registered platforms.
|
|
"""
|
|
info = PLATFORMS.get(key)
|
|
if info is not None:
|
|
return info.label
|
|
# Check plugin registry
|
|
try:
|
|
from gateway.platform_registry import platform_registry
|
|
entry = platform_registry.get(key)
|
|
if entry:
|
|
return f"{entry.emoji} {entry.label}" if entry.emoji else entry.label
|
|
except Exception:
|
|
pass
|
|
return default
|
|
|
|
|
|
def get_all_platforms() -> "OrderedDict[str, PlatformInfo]":
|
|
"""Return PLATFORMS merged with any plugin-registered platforms.
|
|
|
|
Plugin platforms are appended after builtins. This is the function
|
|
that tools_config and skills_config should use for platform 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(
|
|
label=f"{entry.emoji} {entry.label}" if entry.emoji else entry.label,
|
|
default_toolset=f"hermes-{entry.name}",
|
|
)
|
|
except Exception:
|
|
pass
|
|
return merged
|