"""Signal plugin registration: configured/validate checks and ``register``.""" import logging from gateway.config import PlatformConfig from gateway.platforms._shared import env_is_connected from gateway.platforms._shared import config_connected_extra from gateway.platforms.send_targets import NOT_EXPLICIT, StandaloneSendPolicy # Absolute imports (see __init__.py): one canonical module per file. from plugins.platforms.signal.adapter import ( MAX_MESSAGE_LENGTH, SignalAdapter, check_signal_requirements, validate_signal_config) from plugins.platforms.signal.setup import interactive_setup from plugins.platforms.signal.standalone import standalone_send logger = logging.getLogger(__name__) _env_configured = env_is_connected("SIGNAL_HTTP_URL", "SIGNAL_ACCOUNT") def _is_connected(config: PlatformConfig) -> bool: """URL + account from config/scoped env, else ``.env``: a plain CLI process never loads ``.env`` into the environment, and the old static setup row read it, so a ``.env``-only profile stays "configured" in ``hermes gateway setup``.""" return validate_signal_config(config) or _env_configured(config) def _validate_config(config: PlatformConfig) -> bool: """``validate_config``: same warning the core instantiation path logged before the move.""" if validate_signal_config(config): return True logger.warning("Signal: SIGNAL_HTTP_URL or SIGNAL_ACCOUNT not configured") return False # System-prompt platform hint (PlatformEntry.platform_hint); cached-prompt bytes, keep stable. _PLATFORM_HINT = ( "You are on Signal. Standard markdown (**bold**, *italic*, ~~strike~~, # headers, `code`) auto-converts to " "Signal formatting; bullets render as \u2022. No tables \u2014 use bullets or labeled lines. " "You can send files natively: write MEDIA:/absolute/path/to/file in your response. " "Images (.png, .jpg, .webp) send as photos, other files as documents; ![alt](url) sends as photos." ) def _parse_send_target(ref): # "group:" is a native group target; an empty id is not explicit. stripped = ref.strip() if not stripped.startswith("group:"): return None group_id = stripped[len("group:"):].strip() return (f"group:{group_id}", None) if group_id else NOT_EXPLICIT def register(ctx) -> None: """Plugin entry point — called by the Hermes plugin system.""" from . import gateway_env # env -> GatewayConfig bridge (gateway.config_env) ctx.register_platform( target_ref_syntax_fn=_parse_send_target, # Attachments ride the JSON-RPC param on the final chunk. standalone_send=StandaloneSendPolicy(label="Signal", media=True, empty_list_between_chunks=True, text_direct=True), name="signal", label="Signal", adapter_factory=SignalAdapter, dashboard_description="Connect through a signal-cli REST bridge.", docs_url="https://github.com/bbernhard/signal-cli-rest-api", dashboard_env_vars=("SIGNAL_HTTP_URL", "SIGNAL_ACCOUNT", "SIGNAL_ALLOWED_USERS"), check_fn=check_signal_requirements, validate_config=_validate_config, is_connected=_is_connected, required_env=["SIGNAL_HTTP_URL", "SIGNAL_ACCOUNT"], config_connected_fn=config_connected_extra("http_url"), install_hint="Signal: runtime requirements not met", setup_fn=interactive_setup, cron_deliver_env_var="SIGNAL_HOME_CHANNEL", # Out-of-process sends speak raw JSON-RPC and bypass SignalAdapter.send()'s chunking, so # send_message splits at the adapter's limit through this field. standalone_sender_fn=standalone_send, max_message_length=MAX_MESSAGE_LENGTH, emoji="📡", pii_safe=True, allow_update_command=True, platform_hint=_PLATFORM_HINT, display_tier="low", env_overrides=gateway_env.ENV_OVERRIDES, env_enable_credentials=gateway_env.ENV_ENABLE_CREDENTIALS, **gateway_env.AUTHZ, )