Files
hermes-agent/hermes_cli/gateway_multiplex_served.py
T
Teknium 65fd3a2b9c feat(status): show each served profile's shared-listener callback URLs
hermes -p <name> gateway status, hermes gateway status and hermes status (under
Serves:) list the /p/<profile>/<path> URL per inbound-port platform the live
multiplexer serves, read from the <profile>:<platform> ingress_url in the default
home's gateway_state.json (hermes_cli/gateway_multiplex_served.py). The dashboard's
messaging payload carries the same ingress_url and the Channels page renders it.
The dashboard's 409 guard now covers only api_server/webhook (the mirrored pair):
enabling Twilio/LINE/Teams/... on a secondary is allowed because the gateway serves
it.
2026-09-12 01:53:15 -07:00

75 lines
3.6 KiB
Python

"""Which profiles does the LIVE default multiplexer serve? One answer for every CLI/dashboard surface.
``gateway/run_adapters.py::_record_served_profiles`` writes ``served_profiles`` into the default
home's ``gateway_state.json`` at startup. That record is the truth about the running process; the
default ``config.yaml`` plus ``GATEWAY_MULTIPLEX_PROFILES`` as seen by the *CLI* process is only a
guess (``hermes -p coder ...`` loads coder's ``.env``, so an env-only opt-in on the default profile
is invisible to it, and an allowlist edited after start flips the guess before the restart).
"""
from __future__ import annotations
import logging
from pathlib import Path
from typing import Optional
logger = logging.getLogger(__name__)
def live_default_gateway_pid() -> Optional[int]:
"""PID of the default profile's gateway when its pid record names a live process, else None."""
from hermes_constants import get_default_hermes_root
from gateway.status import _pid_exists, _pid_from_record, _read_pid_record
rec = _read_pid_record(get_default_hermes_root() / "gateway.pid")
pid = _pid_from_record(rec) if rec else None
return pid if pid and _pid_exists(pid) else None
def recorded_served_profiles(default_root: Optional[Path] = None) -> Optional[list[str]]:
"""``served_profiles`` the live default gateway recorded, or None when the key is absent (a record
from before the multiplexer recorded it, or a stopped/absent gateway). Callers fall back to config
derivation only on None: an empty list is an authoritative "serves nobody else"."""
from hermes_constants import get_default_hermes_root
from gateway.status import read_runtime_status
if live_default_gateway_pid() is None:
return None
runtime = read_runtime_status((default_root or get_default_hermes_root()) / "gateway_state.json")
served = (runtime or {}).get("served_profiles")
return [str(p) for p in served] if isinstance(served, list) else None
def multiplexer_served_secondaries() -> list[str]:
"""Named profiles the live default multiplexer serves (excludes ``default``); empty when none."""
return [p for p in (recorded_served_profiles() or []) if p and p != "default"]
def served_profile_ingress_urls(profile: Optional[str] = None) -> dict[str, dict[str, str]]:
"""``{profile: {platform: url}}`` for every secondary inbound-port platform the live multiplexer
serves on its shared listener (``<profile>:<platform>`` entries carrying ``ingress_url``). This is
what the user pastes into the vendor console (Twilio, LINE, Teams, ...). ``profile`` narrows the map."""
from hermes_constants import get_default_hermes_root
from gateway.status import read_runtime_status
if live_default_gateway_pid() is None:
return {}
runtime = read_runtime_status(get_default_hermes_root() / "gateway_state.json") or {}
platforms = runtime.get("platforms")
if not isinstance(platforms, dict):
return {}
urls: dict[str, dict[str, str]] = {}
for key, entry in platforms.items():
if not (isinstance(key, str) and ":" in key and isinstance(entry, dict)):
continue
url = entry.get("ingress_url")
if not url or entry.get("state") in ("fatal", "disconnected", "stopped"):
continue
name, platform = key.split(":", 1)
if profile and name != profile:
continue
urls.setdefault(name, {})[platform] = str(url)
return urls
def format_ingress_url_lines(urls: dict[str, str], indent: str = " ") -> list[str]:
"""One ``<indent><platform>: <url>`` line per platform, sorted."""
return [f"{indent}{platform}: {url}" for platform, url in sorted(urls.items())]