""" Gateway configuration management. Handles loading and validating configuration for: - Connected platforms (Telegram, Discord, WhatsApp) - Home channels for each platform - Session reset policies - Delivery preferences """ import logging import os import json from pathlib import Path from dataclasses import dataclass, field from typing import Dict, List, Optional, Any from enum import Enum from hermes_cli.config import get_hermes_home logger = logging.getLogger(__name__) def _coerce_bool(value: Any, default: bool = True) -> bool: """Coerce bool-ish config values, preserving a caller-provided default.""" if value is None: return default if isinstance(value, bool): return value if isinstance(value, str): return value.strip().lower() in ("true", "1", "yes", "on") return bool(value) def _normalize_unauthorized_dm_behavior(value: Any, default: str = "pair") -> str: """Normalize unauthorized DM behavior to a supported value.""" if isinstance(value, str): normalized = value.strip().lower() if normalized in {"pair", "ignore"}: return normalized return default class Platform(Enum): """Supported messaging platforms.""" LOCAL = "local" TELEGRAM = "telegram" DISCORD = "discord" WHATSAPP = "whatsapp" SLACK = "slack" SIGNAL = "signal" MATTERMOST = "mattermost" MATRIX = "matrix" HOMEASSISTANT = "homeassistant" EMAIL = "email" SMS = "sms" DINGTALK = "dingtalk" API_SERVER = "api_server" WEBHOOK = "webhook" FEISHU = "feishu" WECOM = "wecom" @dataclass class HomeChannel: """ Default destination for a platform. When a cron job specifies deliver="telegram" without a specific chat ID, messages are sent to this home channel. """ platform: Platform chat_id: str name: str # Human-readable name for display def to_dict(self) -> Dict[str, Any]: return { "platform": self.platform.value, "chat_id": self.chat_id, "name": self.name, } @classmethod def from_dict(cls, data: Dict[str, Any]) -> "HomeChannel": return cls( platform=Platform(data["platform"]), chat_id=str(data["chat_id"]), name=data.get("name", "Home"), ) @dataclass class SessionResetPolicy: """ Controls when sessions reset (lose context). Modes: - "daily": Reset at a specific hour each day - "idle": Reset after N minutes of inactivity - "both": Whichever triggers first (daily boundary OR idle timeout) - "none": Never auto-reset (context managed only by compression) """ mode: str = "both" # "daily", "idle", "both", or "none" at_hour: int = 4 # Hour for daily reset (0-23, local time) idle_minutes: int = 1440 # Minutes of inactivity before reset (24 hours) notify: bool = True # Send a notification to the user when auto-reset occurs notify_exclude_platforms: tuple = ("api_server", "webhook") # Platforms that don't get reset notifications def to_dict(self) -> Dict[str, Any]: return { "mode": self.mode, "at_hour": self.at_hour, "idle_minutes": self.idle_minutes, "notify": self.notify, "notify_exclude_platforms": list(self.notify_exclude_platforms), } @classmethod def from_dict(cls, data: Dict[str, Any]) -> "SessionResetPolicy": # Handle both missing keys and explicit null values (YAML null → None) mode = data.get("mode") at_hour = data.get("at_hour") idle_minutes = data.get("idle_minutes") notify = data.get("notify") exclude = data.get("notify_exclude_platforms") return cls( mode=mode if mode is not None else "both", at_hour=at_hour if at_hour is not None else 4, idle_minutes=idle_minutes if idle_minutes is not None else 1440, notify=notify if notify is not None else True, notify_exclude_platforms=tuple(exclude) if exclude is not None else ("api_server", "webhook"), ) @dataclass class PlatformConfig: """Configuration for a single messaging platform.""" enabled: bool = False token: Optional[str] = None # Bot token (Telegram, Discord) api_key: Optional[str] = None # API key if different from token home_channel: Optional[HomeChannel] = None # Reply threading mode (Telegram/Slack) # - "off": Never thread replies to original message # - "first": Only first chunk threads to user's message (default) # - "all": All chunks in multi-part replies thread to user's message reply_to_mode: str = "first" # Platform-specific settings extra: Dict[str, Any] = field(default_factory=dict) def to_dict(self) -> Dict[str, Any]: result = { "enabled": self.enabled, "extra": self.extra, "reply_to_mode": self.reply_to_mode, } if self.token: result["token"] = self.token if self.api_key: result["api_key"] = self.api_key if self.home_channel: result["home_channel"] = self.home_channel.to_dict() return result @classmethod def from_dict(cls, data: Dict[str, Any]) -> "PlatformConfig": home_channel = None if "home_channel" in data: home_channel = HomeChannel.from_dict(data["home_channel"]) return cls( enabled=data.get("enabled", False), token=data.get("token"), api_key=data.get("api_key"), home_channel=home_channel, reply_to_mode=data.get("reply_to_mode", "first"), extra=data.get("extra", {}), ) @dataclass class StreamingConfig: """Configuration for real-time token streaming to messaging platforms.""" enabled: bool = False transport: str = "edit" # "edit" (progressive editMessageText) or "off" edit_interval: float = 0.3 # Seconds between message edits buffer_threshold: int = 40 # Chars before forcing an edit cursor: str = " ▉" # Cursor shown during streaming def to_dict(self) -> Dict[str, Any]: return { "enabled": self.enabled, "transport": self.transport, "edit_interval": self.edit_interval, "buffer_threshold": self.buffer_threshold, "cursor": self.cursor, } @classmethod def from_dict(cls, data: Dict[str, Any]) -> "StreamingConfig": if not data: return cls() return cls( enabled=data.get("enabled", False), transport=data.get("transport", "edit"), edit_interval=float(data.get("edit_interval", 0.3)), buffer_threshold=int(data.get("buffer_threshold", 40)), cursor=data.get("cursor", " ▉"), ) @dataclass class GatewayConfig: """ Main gateway configuration. Manages all platform connections, session policies, and delivery settings. """ # Platform configurations platforms: Dict[Platform, PlatformConfig] = field(default_factory=dict) # Session reset policies by type default_reset_policy: SessionResetPolicy = field(default_factory=SessionResetPolicy) reset_by_type: Dict[str, SessionResetPolicy] = field(default_factory=dict) reset_by_platform: Dict[Platform, SessionResetPolicy] = field(default_factory=dict) # Reset trigger commands reset_triggers: List[str] = field(default_factory=lambda: ["/new", "/reset"]) # User-defined quick commands (slash commands that bypass the agent loop) quick_commands: Dict[str, Any] = field(default_factory=dict) # Storage paths sessions_dir: Path = field(default_factory=lambda: get_hermes_home() / "sessions") # Delivery settings always_log_local: bool = True # Always save cron outputs to local files # STT settings stt_enabled: bool = True # Whether to auto-transcribe inbound voice messages # Session isolation in shared chats group_sessions_per_user: bool = True # Isolate group/channel sessions per participant when user IDs are available # Unauthorized DM policy unauthorized_dm_behavior: str = "pair" # "pair" or "ignore" # Streaming configuration streaming: StreamingConfig = field(default_factory=StreamingConfig) def get_connected_platforms(self) -> List[Platform]: """Return list of platforms that are enabled and configured.""" connected = [] for platform, config in self.platforms.items(): if not config.enabled: continue # Platforms that use token/api_key auth if config.token or config.api_key: connected.append(platform) # WhatsApp uses enabled flag only (bridge handles auth) elif platform == Platform.WHATSAPP: connected.append(platform) # Signal uses extra dict for config (http_url + account) elif platform == Platform.SIGNAL and config.extra.get("http_url"): connected.append(platform) # Email uses extra dict for config (address + imap_host + smtp_host) elif platform == Platform.EMAIL and config.extra.get("address"): connected.append(platform) # SMS uses api_key (Twilio auth token) — SID checked via env elif platform == Platform.SMS and os.getenv("TWILIO_ACCOUNT_SID"): connected.append(platform) # API Server uses enabled flag only (no token needed) elif platform == Platform.API_SERVER: connected.append(platform) # Webhook uses enabled flag only (secrets are per-route) elif platform == Platform.WEBHOOK: connected.append(platform) # Feishu uses extra dict for app credentials elif platform == Platform.FEISHU and config.extra.get("app_id"): connected.append(platform) # WeCom uses extra dict for bot credentials elif platform == Platform.WECOM and config.extra.get("bot_id"): connected.append(platform) return connected def get_home_channel(self, platform: Platform) -> Optional[HomeChannel]: """Get the home channel for a platform.""" config = self.platforms.get(platform) if config: return config.home_channel return None def get_reset_policy( self, platform: Optional[Platform] = None, session_type: Optional[str] = None ) -> SessionResetPolicy: """ Get the appropriate reset policy for a session. Priority: platform override > type override > default """ # Platform-specific override takes precedence if platform and platform in self.reset_by_platform: return self.reset_by_platform[platform] # Type-specific override (dm, group, thread) if session_type and session_type in self.reset_by_type: return self.reset_by_type[session_type] return self.default_reset_policy def to_dict(self) -> Dict[str, Any]: return { "platforms": { p.value: c.to_dict() for p, c in self.platforms.items() }, "default_reset_policy": self.default_reset_policy.to_dict(), "reset_by_type": { k: v.to_dict() for k, v in self.reset_by_type.items() }, "reset_by_platform": { p.value: v.to_dict() for p, v in self.reset_by_platform.items() }, "reset_triggers": self.reset_triggers, "quick_commands": self.quick_commands, "sessions_dir": str(self.sessions_dir), "always_log_local": self.always_log_local, "stt_enabled": self.stt_enabled, "group_sessions_per_user": self.group_sessions_per_user, "unauthorized_dm_behavior": self.unauthorized_dm_behavior, "streaming": self.streaming.to_dict(), } @classmethod def from_dict(cls, data: Dict[str, Any]) -> "GatewayConfig": platforms = {} for platform_name, platform_data in data.get("platforms", {}).items(): try: platform = Platform(platform_name) platforms[platform] = PlatformConfig.from_dict(platform_data) except ValueError: pass # Skip unknown platforms reset_by_type = {} for type_name, policy_data in data.get("reset_by_type", {}).items(): reset_by_type[type_name] = SessionResetPolicy.from_dict(policy_data) reset_by_platform = {} for platform_name, policy_data in data.get("reset_by_platform", {}).items(): try: platform = Platform(platform_name) reset_by_platform[platform] = SessionResetPolicy.from_dict(policy_data) except ValueError: pass default_policy = SessionResetPolicy() if "default_reset_policy" in data: default_policy = SessionResetPolicy.from_dict(data["default_reset_policy"]) sessions_dir = get_hermes_home() / "sessions" if "sessions_dir" in data: sessions_dir = Path(data["sessions_dir"]) quick_commands = data.get("quick_commands", {}) if not isinstance(quick_commands, dict): quick_commands = {} stt_enabled = data.get("stt_enabled") if stt_enabled is None: stt_enabled = data.get("stt", {}).get("enabled") if isinstance(data.get("stt"), dict) else None group_sessions_per_user = data.get("group_sessions_per_user") unauthorized_dm_behavior = _normalize_unauthorized_dm_behavior( data.get("unauthorized_dm_behavior"), "pair", ) return cls( platforms=platforms, default_reset_policy=default_policy, reset_by_type=reset_by_type, reset_by_platform=reset_by_platform, reset_triggers=data.get("reset_triggers", ["/new", "/reset"]), quick_commands=quick_commands, sessions_dir=sessions_dir, always_log_local=data.get("always_log_local", True), stt_enabled=_coerce_bool(stt_enabled, True), group_sessions_per_user=_coerce_bool(group_sessions_per_user, True), unauthorized_dm_behavior=unauthorized_dm_behavior, streaming=StreamingConfig.from_dict(data.get("streaming", {})), ) def get_unauthorized_dm_behavior(self, platform: Optional[Platform] = None) -> str: """Return the effective unauthorized-DM behavior for a platform.""" if platform: platform_cfg = self.platforms.get(platform) if platform_cfg and "unauthorized_dm_behavior" in platform_cfg.extra: return _normalize_unauthorized_dm_behavior( platform_cfg.extra.get("unauthorized_dm_behavior"), self.unauthorized_dm_behavior, ) return self.unauthorized_dm_behavior def load_gateway_config() -> GatewayConfig: """ Load gateway configuration from multiple sources. Priority (highest to lowest): 1. Environment variables 2. ~/.hermes/config.yaml (primary user-facing config) 3. ~/.hermes/gateway.json (legacy — provides defaults under config.yaml) 4. Built-in defaults """ _home = get_hermes_home() gw_data: dict = {} # Legacy fallback: gateway.json provides the base layer. # config.yaml keys always win when both specify the same setting. gateway_json_path = _home / "gateway.json" if gateway_json_path.exists(): try: with open(gateway_json_path, "r", encoding="utf-8") as f: gw_data = json.load(f) or {} logger.info( "Loaded legacy %s — consider moving settings to config.yaml", gateway_json_path, ) except Exception as e: logger.warning("Failed to load %s: %s", gateway_json_path, e) # Primary source: config.yaml try: import yaml config_yaml_path = _home / "config.yaml" if config_yaml_path.exists(): with open(config_yaml_path, encoding="utf-8") as f: yaml_cfg = yaml.safe_load(f) or {} # Map config.yaml keys → GatewayConfig.from_dict() schema. # Each key overwrites whatever gateway.json may have set. sr = yaml_cfg.get("session_reset") if sr and isinstance(sr, dict): gw_data["default_reset_policy"] = sr qc = yaml_cfg.get("quick_commands") if qc is not None: if isinstance(qc, dict): gw_data["quick_commands"] = qc else: logger.warning( "Ignoring invalid quick_commands in config.yaml " "(expected mapping, got %s)", type(qc).__name__, ) stt_cfg = yaml_cfg.get("stt") if isinstance(stt_cfg, dict): gw_data["stt"] = stt_cfg if "group_sessions_per_user" in yaml_cfg: gw_data["group_sessions_per_user"] = yaml_cfg["group_sessions_per_user"] streaming_cfg = yaml_cfg.get("streaming") if isinstance(streaming_cfg, dict): gw_data["streaming"] = streaming_cfg if "reset_triggers" in yaml_cfg: gw_data["reset_triggers"] = yaml_cfg["reset_triggers"] if "always_log_local" in yaml_cfg: gw_data["always_log_local"] = yaml_cfg["always_log_local"] if "unauthorized_dm_behavior" in yaml_cfg: gw_data["unauthorized_dm_behavior"] = _normalize_unauthorized_dm_behavior( yaml_cfg.get("unauthorized_dm_behavior"), "pair", ) # Merge platforms section from config.yaml into gw_data so that # nested keys like platforms.webhook.extra.routes are loaded. yaml_platforms = yaml_cfg.get("platforms") platforms_data = gw_data.setdefault("platforms", {}) if not isinstance(platforms_data, dict): platforms_data = {} gw_data["platforms"] = platforms_data if isinstance(yaml_platforms, dict): for plat_name, plat_block in yaml_platforms.items(): if not isinstance(plat_block, dict): continue existing = platforms_data.get(plat_name, {}) if not isinstance(existing, dict): existing = {} # Deep-merge extra dicts so gateway.json defaults survive merged_extra = {**existing.get("extra", {}), **plat_block.get("extra", {})} merged = {**existing, **plat_block} if merged_extra: merged["extra"] = merged_extra platforms_data[plat_name] = merged gw_data["platforms"] = platforms_data for plat in Platform: if plat == Platform.LOCAL: continue platform_cfg = yaml_cfg.get(plat.value) if not isinstance(platform_cfg, dict): continue # Collect bridgeable keys from this platform section bridged = {} if "unauthorized_dm_behavior" in platform_cfg: bridged["unauthorized_dm_behavior"] = _normalize_unauthorized_dm_behavior( platform_cfg.get("unauthorized_dm_behavior"), gw_data.get("unauthorized_dm_behavior", "pair"), ) if "reply_prefix" in platform_cfg: bridged["reply_prefix"] = platform_cfg["reply_prefix"] if "require_mention" in platform_cfg: bridged["require_mention"] = platform_cfg["require_mention"] if "mention_patterns" in platform_cfg: bridged["mention_patterns"] = platform_cfg["mention_patterns"] if not bridged: continue plat_data = platforms_data.setdefault(plat.value, {}) if not isinstance(plat_data, dict): plat_data = {} platforms_data[plat.value] = plat_data extra = plat_data.setdefault("extra", {}) if not isinstance(extra, dict): extra = {} plat_data["extra"] = extra extra.update(bridged) # Discord settings → env vars (env vars take precedence) discord_cfg = yaml_cfg.get("discord", {}) if isinstance(discord_cfg, dict): if "require_mention" in discord_cfg and not os.getenv("DISCORD_REQUIRE_MENTION"): os.environ["DISCORD_REQUIRE_MENTION"] = str(discord_cfg["require_mention"]).lower() frc = discord_cfg.get("free_response_channels") if frc is not None and not os.getenv("DISCORD_FREE_RESPONSE_CHANNELS"): if isinstance(frc, list): frc = ",".join(str(v) for v in frc) os.environ["DISCORD_FREE_RESPONSE_CHANNELS"] = str(frc) if "auto_thread" in discord_cfg and not os.getenv("DISCORD_AUTO_THREAD"): os.environ["DISCORD_AUTO_THREAD"] = str(discord_cfg["auto_thread"]).lower() # Telegram settings → env vars (env vars take precedence) telegram_cfg = yaml_cfg.get("telegram", {}) if isinstance(telegram_cfg, dict): if "require_mention" in telegram_cfg and not os.getenv("TELEGRAM_REQUIRE_MENTION"): os.environ["TELEGRAM_REQUIRE_MENTION"] = str(telegram_cfg["require_mention"]).lower() if "mention_patterns" in telegram_cfg and not os.getenv("TELEGRAM_MENTION_PATTERNS"): import json as _json os.environ["TELEGRAM_MENTION_PATTERNS"] = _json.dumps(telegram_cfg["mention_patterns"]) frc = telegram_cfg.get("free_response_chats") if frc is not None and not os.getenv("TELEGRAM_FREE_RESPONSE_CHATS"): if isinstance(frc, list): frc = ",".join(str(v) for v in frc) os.environ["TELEGRAM_FREE_RESPONSE_CHATS"] = str(frc) except Exception as e: logger.warning( "Failed to process config.yaml — falling back to .env / gateway.json values. " "Check %s for syntax errors. Error: %s", _home / "config.yaml", e, ) config = GatewayConfig.from_dict(gw_data) # Override with environment variables _apply_env_overrides(config) # --- Validate loaded values --- policy = config.default_reset_policy if not (0 <= policy.at_hour <= 23): logger.warning( "Invalid at_hour=%s (must be 0-23). Using default 4.", policy.at_hour ) policy.at_hour = 4 if policy.idle_minutes is None or policy.idle_minutes <= 0: logger.warning( "Invalid idle_minutes=%s (must be positive). Using default 1440.", policy.idle_minutes, ) policy.idle_minutes = 1440 # Warn about empty bot tokens — platforms that loaded an empty string # won't connect and the cause can be confusing without a log line. _token_env_names = { Platform.TELEGRAM: "TELEGRAM_BOT_TOKEN", Platform.DISCORD: "DISCORD_BOT_TOKEN", Platform.SLACK: "SLACK_BOT_TOKEN", Platform.MATTERMOST: "MATTERMOST_TOKEN", Platform.MATRIX: "MATRIX_ACCESS_TOKEN", } for platform, pconfig in config.platforms.items(): if not pconfig.enabled: continue env_name = _token_env_names.get(platform) if env_name and pconfig.token is not None and not pconfig.token.strip(): logger.warning( "%s is enabled but %s is empty. " "The adapter will likely fail to connect.", platform.value, env_name, ) return config def _apply_env_overrides(config: GatewayConfig) -> None: """Apply environment variable overrides to config.""" # Telegram telegram_token = os.getenv("TELEGRAM_BOT_TOKEN") if telegram_token: if Platform.TELEGRAM not in config.platforms: config.platforms[Platform.TELEGRAM] = PlatformConfig() config.platforms[Platform.TELEGRAM].enabled = True config.platforms[Platform.TELEGRAM].token = telegram_token # Reply threading mode for Telegram (off/first/all) telegram_reply_mode = os.getenv("TELEGRAM_REPLY_TO_MODE", "").lower() if telegram_reply_mode in ("off", "first", "all"): if Platform.TELEGRAM not in config.platforms: config.platforms[Platform.TELEGRAM] = PlatformConfig() config.platforms[Platform.TELEGRAM].reply_to_mode = telegram_reply_mode telegram_fallback_ips = os.getenv("TELEGRAM_FALLBACK_IPS", "") if telegram_fallback_ips: if Platform.TELEGRAM not in config.platforms: config.platforms[Platform.TELEGRAM] = PlatformConfig() config.platforms[Platform.TELEGRAM].extra["fallback_ips"] = [ ip.strip() for ip in telegram_fallback_ips.split(",") if ip.strip() ] telegram_home = os.getenv("TELEGRAM_HOME_CHANNEL") if telegram_home and Platform.TELEGRAM in config.platforms: config.platforms[Platform.TELEGRAM].home_channel = HomeChannel( platform=Platform.TELEGRAM, chat_id=telegram_home, name=os.getenv("TELEGRAM_HOME_CHANNEL_NAME", "Home"), ) # Discord discord_token = os.getenv("DISCORD_BOT_TOKEN") if discord_token: if Platform.DISCORD not in config.platforms: config.platforms[Platform.DISCORD] = PlatformConfig() config.platforms[Platform.DISCORD].enabled = True config.platforms[Platform.DISCORD].token = discord_token discord_home = os.getenv("DISCORD_HOME_CHANNEL") if discord_home and Platform.DISCORD in config.platforms: config.platforms[Platform.DISCORD].home_channel = HomeChannel( platform=Platform.DISCORD, chat_id=discord_home, name=os.getenv("DISCORD_HOME_CHANNEL_NAME", "Home"), ) # WhatsApp (typically uses different auth mechanism) whatsapp_enabled = os.getenv("WHATSAPP_ENABLED", "").lower() in ("true", "1", "yes") if whatsapp_enabled: if Platform.WHATSAPP not in config.platforms: config.platforms[Platform.WHATSAPP] = PlatformConfig() config.platforms[Platform.WHATSAPP].enabled = True # Slack slack_token = os.getenv("SLACK_BOT_TOKEN") if slack_token: if Platform.SLACK not in config.platforms: config.platforms[Platform.SLACK] = PlatformConfig() config.platforms[Platform.SLACK].enabled = True config.platforms[Platform.SLACK].token = slack_token slack_home = os.getenv("SLACK_HOME_CHANNEL") if slack_home and Platform.SLACK in config.platforms: config.platforms[Platform.SLACK].home_channel = HomeChannel( platform=Platform.SLACK, chat_id=slack_home, name=os.getenv("SLACK_HOME_CHANNEL_NAME", ""), ) # Signal signal_url = os.getenv("SIGNAL_HTTP_URL") signal_account = os.getenv("SIGNAL_ACCOUNT") if signal_url and signal_account: if Platform.SIGNAL not in config.platforms: config.platforms[Platform.SIGNAL] = PlatformConfig() config.platforms[Platform.SIGNAL].enabled = True config.platforms[Platform.SIGNAL].extra.update({ "http_url": signal_url, "account": signal_account, "ignore_stories": os.getenv("SIGNAL_IGNORE_STORIES", "true").lower() in ("true", "1", "yes"), }) signal_home = os.getenv("SIGNAL_HOME_CHANNEL") if signal_home and Platform.SIGNAL in config.platforms: config.platforms[Platform.SIGNAL].home_channel = HomeChannel( platform=Platform.SIGNAL, chat_id=signal_home, name=os.getenv("SIGNAL_HOME_CHANNEL_NAME", "Home"), ) # Mattermost mattermost_token = os.getenv("MATTERMOST_TOKEN") if mattermost_token: mattermost_url = os.getenv("MATTERMOST_URL", "") if not mattermost_url: logger.warning("MATTERMOST_TOKEN set but MATTERMOST_URL is missing") if Platform.MATTERMOST not in config.platforms: config.platforms[Platform.MATTERMOST] = PlatformConfig() config.platforms[Platform.MATTERMOST].enabled = True config.platforms[Platform.MATTERMOST].token = mattermost_token config.platforms[Platform.MATTERMOST].extra["url"] = mattermost_url mattermost_home = os.getenv("MATTERMOST_HOME_CHANNEL") if mattermost_home and Platform.MATTERMOST in config.platforms: config.platforms[Platform.MATTERMOST].home_channel = HomeChannel( platform=Platform.MATTERMOST, chat_id=mattermost_home, name=os.getenv("MATTERMOST_HOME_CHANNEL_NAME", "Home"), ) # Matrix matrix_token = os.getenv("MATRIX_ACCESS_TOKEN") matrix_homeserver = os.getenv("MATRIX_HOMESERVER", "") if matrix_token or os.getenv("MATRIX_PASSWORD"): if not matrix_homeserver: logger.warning("MATRIX_ACCESS_TOKEN/MATRIX_PASSWORD set but MATRIX_HOMESERVER is missing") if Platform.MATRIX not in config.platforms: config.platforms[Platform.MATRIX] = PlatformConfig() config.platforms[Platform.MATRIX].enabled = True if matrix_token: config.platforms[Platform.MATRIX].token = matrix_token config.platforms[Platform.MATRIX].extra["homeserver"] = matrix_homeserver matrix_user = os.getenv("MATRIX_USER_ID", "") if matrix_user: config.platforms[Platform.MATRIX].extra["user_id"] = matrix_user matrix_password = os.getenv("MATRIX_PASSWORD", "") if matrix_password: config.platforms[Platform.MATRIX].extra["password"] = matrix_password matrix_e2ee = os.getenv("MATRIX_ENCRYPTION", "").lower() in ("true", "1", "yes") config.platforms[Platform.MATRIX].extra["encryption"] = matrix_e2ee matrix_home = os.getenv("MATRIX_HOME_ROOM") if matrix_home and Platform.MATRIX in config.platforms: config.platforms[Platform.MATRIX].home_channel = HomeChannel( platform=Platform.MATRIX, chat_id=matrix_home, name=os.getenv("MATRIX_HOME_ROOM_NAME", "Home"), ) # Home Assistant hass_token = os.getenv("HASS_TOKEN") if hass_token: if Platform.HOMEASSISTANT not in config.platforms: config.platforms[Platform.HOMEASSISTANT] = PlatformConfig() config.platforms[Platform.HOMEASSISTANT].enabled = True config.platforms[Platform.HOMEASSISTANT].token = hass_token hass_url = os.getenv("HASS_URL") if hass_url: config.platforms[Platform.HOMEASSISTANT].extra["url"] = hass_url # Email email_addr = os.getenv("EMAIL_ADDRESS") email_pwd = os.getenv("EMAIL_PASSWORD") email_imap = os.getenv("EMAIL_IMAP_HOST") email_smtp = os.getenv("EMAIL_SMTP_HOST") if all([email_addr, email_pwd, email_imap, email_smtp]): if Platform.EMAIL not in config.platforms: config.platforms[Platform.EMAIL] = PlatformConfig() config.platforms[Platform.EMAIL].enabled = True config.platforms[Platform.EMAIL].extra.update({ "address": email_addr, "imap_host": email_imap, "smtp_host": email_smtp, }) email_home = os.getenv("EMAIL_HOME_ADDRESS") if email_home and Platform.EMAIL in config.platforms: config.platforms[Platform.EMAIL].home_channel = HomeChannel( platform=Platform.EMAIL, chat_id=email_home, name=os.getenv("EMAIL_HOME_ADDRESS_NAME", "Home"), ) # SMS (Twilio) twilio_sid = os.getenv("TWILIO_ACCOUNT_SID") if twilio_sid: if Platform.SMS not in config.platforms: config.platforms[Platform.SMS] = PlatformConfig() config.platforms[Platform.SMS].enabled = True config.platforms[Platform.SMS].api_key = os.getenv("TWILIO_AUTH_TOKEN", "") sms_home = os.getenv("SMS_HOME_CHANNEL") if sms_home and Platform.SMS in config.platforms: config.platforms[Platform.SMS].home_channel = HomeChannel( platform=Platform.SMS, chat_id=sms_home, name=os.getenv("SMS_HOME_CHANNEL_NAME", "Home"), ) # API Server api_server_enabled = os.getenv("API_SERVER_ENABLED", "").lower() in ("true", "1", "yes") api_server_key = os.getenv("API_SERVER_KEY", "") api_server_cors_origins = os.getenv("API_SERVER_CORS_ORIGINS", "") api_server_port = os.getenv("API_SERVER_PORT") api_server_host = os.getenv("API_SERVER_HOST") if api_server_enabled or api_server_key: if Platform.API_SERVER not in config.platforms: config.platforms[Platform.API_SERVER] = PlatformConfig() config.platforms[Platform.API_SERVER].enabled = True if api_server_key: config.platforms[Platform.API_SERVER].extra["key"] = api_server_key if api_server_cors_origins: origins = [origin.strip() for origin in api_server_cors_origins.split(",") if origin.strip()] if origins: config.platforms[Platform.API_SERVER].extra["cors_origins"] = origins if api_server_port: try: config.platforms[Platform.API_SERVER].extra["port"] = int(api_server_port) except ValueError: pass if api_server_host: config.platforms[Platform.API_SERVER].extra["host"] = api_server_host # Webhook platform webhook_enabled = os.getenv("WEBHOOK_ENABLED", "").lower() in ("true", "1", "yes") webhook_port = os.getenv("WEBHOOK_PORT") webhook_secret = os.getenv("WEBHOOK_SECRET", "") if webhook_enabled: if Platform.WEBHOOK not in config.platforms: config.platforms[Platform.WEBHOOK] = PlatformConfig() config.platforms[Platform.WEBHOOK].enabled = True if webhook_port: try: config.platforms[Platform.WEBHOOK].extra["port"] = int(webhook_port) except ValueError: pass if webhook_secret: config.platforms[Platform.WEBHOOK].extra["secret"] = webhook_secret # Feishu / Lark feishu_app_id = os.getenv("FEISHU_APP_ID") feishu_app_secret = os.getenv("FEISHU_APP_SECRET") if feishu_app_id and feishu_app_secret: if Platform.FEISHU not in config.platforms: config.platforms[Platform.FEISHU] = PlatformConfig() config.platforms[Platform.FEISHU].enabled = True config.platforms[Platform.FEISHU].extra.update({ "app_id": feishu_app_id, "app_secret": feishu_app_secret, "domain": os.getenv("FEISHU_DOMAIN", "feishu"), "connection_mode": os.getenv("FEISHU_CONNECTION_MODE", "websocket"), }) feishu_encrypt_key = os.getenv("FEISHU_ENCRYPT_KEY", "") if feishu_encrypt_key: config.platforms[Platform.FEISHU].extra["encrypt_key"] = feishu_encrypt_key feishu_verification_token = os.getenv("FEISHU_VERIFICATION_TOKEN", "") if feishu_verification_token: config.platforms[Platform.FEISHU].extra["verification_token"] = feishu_verification_token feishu_home = os.getenv("FEISHU_HOME_CHANNEL") if feishu_home: config.platforms[Platform.FEISHU].home_channel = HomeChannel( platform=Platform.FEISHU, chat_id=feishu_home, name=os.getenv("FEISHU_HOME_CHANNEL_NAME", "Home"), ) # WeCom (Enterprise WeChat) wecom_bot_id = os.getenv("WECOM_BOT_ID") wecom_secret = os.getenv("WECOM_SECRET") if wecom_bot_id and wecom_secret: if Platform.WECOM not in config.platforms: config.platforms[Platform.WECOM] = PlatformConfig() config.platforms[Platform.WECOM].enabled = True config.platforms[Platform.WECOM].extra.update({ "bot_id": wecom_bot_id, "secret": wecom_secret, }) wecom_ws_url = os.getenv("WECOM_WEBSOCKET_URL", "") if wecom_ws_url: config.platforms[Platform.WECOM].extra["websocket_url"] = wecom_ws_url wecom_home = os.getenv("WECOM_HOME_CHANNEL") if wecom_home: config.platforms[Platform.WECOM].home_channel = HomeChannel( platform=Platform.WECOM, chat_id=wecom_home, name=os.getenv("WECOM_HOME_CHANNEL_NAME", "Home"), ) # Session settings idle_minutes = os.getenv("SESSION_IDLE_MINUTES") if idle_minutes: try: config.default_reset_policy.idle_minutes = int(idle_minutes) except ValueError: pass reset_hour = os.getenv("SESSION_RESET_HOUR") if reset_hour: try: config.default_reset_policy.at_hour = int(reset_hour) except ValueError: pass