mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-04-25 00:51:20 +00:00
d2206c69cc
Follow-up to WideLee's salvaged PR #11582. Back-compat for QQ_HOME_CHANNEL → QQBOT_HOME_CHANNEL rename: - gateway/config.py reads QQBOT_HOME_CHANNEL, falls back to QQ_HOME_CHANNEL with a one-shot deprecation warning so users on the old name aren't silently broken. - cron/scheduler.py: _HOME_TARGET_ENV_VARS['qqbot'] now maps to the new name; _get_home_target_chat_id falls back to the legacy name via a _LEGACY_HOME_TARGET_ENV_VARS table. - hermes_cli/status.py + hermes_cli/setup.py: honor both names when displaying or checking for missing home channels. - hermes_cli/config.py: keep legacy QQ_HOME_CHANNEL[_NAME] in _EXTRA_ENV_KEYS so .env sanitization still recognizes them. Scope cleanup: - Drop qrcode from core dependencies and requirements.txt (remains in messaging/dingtalk/feishu extras). _qqbot_render_qr already degrades gracefully when qrcode is missing, printing a 'pip install qrcode' tip and falling back to URL-only display. - Restore @staticmethod on QQAdapter._detect_message_type (it doesn't use self). Revert the test change that was only needed when it was converted to an instance method. - Reset uv.lock to origin/main; the PR's stale lock also included unrelated changes (atroposlib source URL, hermes-agent version bump, fastapi additions) that don't belong. Verified E2E: - Existing user (QQ_HOME_CHANNEL set): gateway + cron both pick up the legacy name; deprecation warning logs once. - Fresh user (QQBOT_HOME_CHANNEL set): gateway + cron use new name, no warning. - Both set: new name wins on both surfaces. Targeted tests: 296 passed, 4 skipped (qqbot + cron + hermes_cli).
491 lines
20 KiB
Python
491 lines
20 KiB
Python
"""
|
|
Status command for hermes CLI.
|
|
|
|
Shows the status of all Hermes Agent components.
|
|
"""
|
|
|
|
import os
|
|
import sys
|
|
import subprocess
|
|
from pathlib import Path
|
|
|
|
PROJECT_ROOT = Path(__file__).parent.parent.resolve()
|
|
|
|
from hermes_cli.auth import AuthError, resolve_provider
|
|
from hermes_cli.colors import Colors, color
|
|
from hermes_cli.config import get_env_path, get_env_value, get_hermes_home, load_config
|
|
from hermes_cli.models import provider_label
|
|
from hermes_cli.nous_subscription import get_nous_subscription_features
|
|
from hermes_cli.runtime_provider import resolve_requested_provider
|
|
from hermes_constants import OPENROUTER_MODELS_URL
|
|
from tools.tool_backend_helpers import managed_nous_tools_enabled
|
|
|
|
def check_mark(ok: bool) -> str:
|
|
if ok:
|
|
return color("✓", Colors.GREEN)
|
|
return color("✗", Colors.RED)
|
|
|
|
def redact_key(key: str) -> str:
|
|
"""Redact an API key for display."""
|
|
if not key:
|
|
return "(not set)"
|
|
if len(key) < 12:
|
|
return "***"
|
|
return key[:4] + "..." + key[-4:]
|
|
|
|
|
|
def _format_iso_timestamp(value) -> str:
|
|
"""Format ISO timestamps for status output, converting to local timezone."""
|
|
if not value or not isinstance(value, str):
|
|
return "(unknown)"
|
|
from datetime import datetime, timezone
|
|
text = value.strip()
|
|
if not text:
|
|
return "(unknown)"
|
|
if text.endswith("Z"):
|
|
text = text[:-1] + "+00:00"
|
|
try:
|
|
parsed = datetime.fromisoformat(text)
|
|
if parsed.tzinfo is None:
|
|
parsed = parsed.replace(tzinfo=timezone.utc)
|
|
except Exception:
|
|
return value
|
|
return parsed.astimezone().strftime("%Y-%m-%d %H:%M:%S %Z")
|
|
|
|
|
|
def _configured_model_label(config: dict) -> str:
|
|
"""Return the configured default model from config.yaml."""
|
|
model_cfg = config.get("model")
|
|
if isinstance(model_cfg, dict):
|
|
model = (model_cfg.get("default") or model_cfg.get("name") or "").strip()
|
|
elif isinstance(model_cfg, str):
|
|
model = model_cfg.strip()
|
|
else:
|
|
model = ""
|
|
return model or "(not set)"
|
|
|
|
|
|
def _effective_provider_label() -> str:
|
|
"""Return the provider label matching current CLI runtime resolution."""
|
|
requested = resolve_requested_provider()
|
|
try:
|
|
effective = resolve_provider(requested)
|
|
except AuthError:
|
|
effective = requested or "auto"
|
|
|
|
if effective == "openrouter" and get_env_value("OPENAI_BASE_URL"):
|
|
effective = "custom"
|
|
|
|
return provider_label(effective)
|
|
|
|
|
|
from hermes_constants import is_termux as _is_termux
|
|
|
|
|
|
def show_status(args):
|
|
"""Show status of all Hermes Agent components."""
|
|
show_all = getattr(args, 'all', False)
|
|
deep = getattr(args, 'deep', False)
|
|
|
|
print()
|
|
print(color("┌─────────────────────────────────────────────────────────┐", Colors.CYAN))
|
|
print(color("│ ⚕ Hermes Agent Status │", Colors.CYAN))
|
|
print(color("└─────────────────────────────────────────────────────────┘", Colors.CYAN))
|
|
|
|
# =========================================================================
|
|
# Environment
|
|
# =========================================================================
|
|
print()
|
|
print(color("◆ Environment", Colors.CYAN, Colors.BOLD))
|
|
print(f" Project: {PROJECT_ROOT}")
|
|
print(f" Python: {sys.version.split()[0]}")
|
|
|
|
env_path = get_env_path()
|
|
print(f" .env file: {check_mark(env_path.exists())} {'exists' if env_path.exists() else 'not found'}")
|
|
|
|
try:
|
|
config = load_config()
|
|
except Exception:
|
|
config = {}
|
|
|
|
print(f" Model: {_configured_model_label(config)}")
|
|
print(f" Provider: {_effective_provider_label()}")
|
|
|
|
# =========================================================================
|
|
# API Keys
|
|
# =========================================================================
|
|
print()
|
|
print(color("◆ API Keys", Colors.CYAN, Colors.BOLD))
|
|
|
|
keys = {
|
|
"OpenRouter": "OPENROUTER_API_KEY",
|
|
"OpenAI": "OPENAI_API_KEY",
|
|
"Z.AI/GLM": "GLM_API_KEY",
|
|
"Kimi": "KIMI_API_KEY",
|
|
"MiniMax": "MINIMAX_API_KEY",
|
|
"MiniMax-CN": "MINIMAX_CN_API_KEY",
|
|
"Firecrawl": "FIRECRAWL_API_KEY",
|
|
"Tavily": "TAVILY_API_KEY",
|
|
"Browser Use": "BROWSER_USE_API_KEY", # Optional — local browser works without this
|
|
"Browserbase": "BROWSERBASE_API_KEY", # Optional — direct credentials only
|
|
"FAL": "FAL_KEY",
|
|
"Tinker": "TINKER_API_KEY",
|
|
"WandB": "WANDB_API_KEY",
|
|
"ElevenLabs": "ELEVENLABS_API_KEY",
|
|
"GitHub": "GITHUB_TOKEN",
|
|
}
|
|
|
|
for name, env_var in keys.items():
|
|
value = get_env_value(env_var) or ""
|
|
has_key = bool(value)
|
|
display = redact_key(value) if not show_all else value
|
|
print(f" {name:<12} {check_mark(has_key)} {display}")
|
|
|
|
from hermes_cli.auth import get_anthropic_key
|
|
anthropic_value = get_anthropic_key()
|
|
anthropic_display = redact_key(anthropic_value) if not show_all else anthropic_value
|
|
print(f" {'Anthropic':<12} {check_mark(bool(anthropic_value))} {anthropic_display}")
|
|
|
|
# =========================================================================
|
|
# Auth Providers (OAuth)
|
|
# =========================================================================
|
|
print()
|
|
print(color("◆ Auth Providers", Colors.CYAN, Colors.BOLD))
|
|
|
|
try:
|
|
from hermes_cli.auth import get_nous_auth_status, get_codex_auth_status, get_qwen_auth_status
|
|
nous_status = get_nous_auth_status()
|
|
codex_status = get_codex_auth_status()
|
|
qwen_status = get_qwen_auth_status()
|
|
except Exception:
|
|
nous_status = {}
|
|
codex_status = {}
|
|
qwen_status = {}
|
|
|
|
nous_logged_in = bool(nous_status.get("logged_in"))
|
|
print(
|
|
f" {'Nous Portal':<12} {check_mark(nous_logged_in)} "
|
|
f"{'logged in' if nous_logged_in else 'not logged in (run: hermes model)'}"
|
|
)
|
|
if nous_logged_in:
|
|
portal_url = nous_status.get("portal_base_url") or "(unknown)"
|
|
access_exp = _format_iso_timestamp(nous_status.get("access_expires_at"))
|
|
key_exp = _format_iso_timestamp(nous_status.get("agent_key_expires_at"))
|
|
refresh_label = "yes" if nous_status.get("has_refresh_token") else "no"
|
|
print(f" Portal URL: {portal_url}")
|
|
print(f" Access exp: {access_exp}")
|
|
print(f" Key exp: {key_exp}")
|
|
print(f" Refresh: {refresh_label}")
|
|
|
|
codex_logged_in = bool(codex_status.get("logged_in"))
|
|
print(
|
|
f" {'OpenAI Codex':<12} {check_mark(codex_logged_in)} "
|
|
f"{'logged in' if codex_logged_in else 'not logged in (run: hermes model)'}"
|
|
)
|
|
codex_auth_file = codex_status.get("auth_store")
|
|
if codex_auth_file:
|
|
print(f" Auth file: {codex_auth_file}")
|
|
codex_last_refresh = _format_iso_timestamp(codex_status.get("last_refresh"))
|
|
if codex_status.get("last_refresh"):
|
|
print(f" Refreshed: {codex_last_refresh}")
|
|
if codex_status.get("error") and not codex_logged_in:
|
|
print(f" Error: {codex_status.get('error')}")
|
|
|
|
qwen_logged_in = bool(qwen_status.get("logged_in"))
|
|
print(
|
|
f" {'Qwen OAuth':<12} {check_mark(qwen_logged_in)} "
|
|
f"{'logged in' if qwen_logged_in else 'not logged in (run: qwen auth qwen-oauth)'}"
|
|
)
|
|
qwen_auth_file = qwen_status.get("auth_file")
|
|
if qwen_auth_file:
|
|
print(f" Auth file: {qwen_auth_file}")
|
|
qwen_exp = qwen_status.get("expires_at_ms")
|
|
if qwen_exp:
|
|
from datetime import datetime, timezone
|
|
print(f" Access exp: {datetime.fromtimestamp(int(qwen_exp) / 1000, tz=timezone.utc).isoformat()}")
|
|
if qwen_status.get("error") and not qwen_logged_in:
|
|
print(f" Error: {qwen_status.get('error')}")
|
|
|
|
# =========================================================================
|
|
# Nous Subscription Features
|
|
# =========================================================================
|
|
if managed_nous_tools_enabled():
|
|
features = get_nous_subscription_features(config)
|
|
print()
|
|
print(color("◆ Nous Tool Gateway", Colors.CYAN, Colors.BOLD))
|
|
if not features.nous_auth_present:
|
|
print(" Nous Portal ✗ not logged in")
|
|
else:
|
|
print(" Nous Portal ✓ managed tools available")
|
|
for feature in features.items():
|
|
if feature.managed_by_nous:
|
|
state = "active via Nous subscription"
|
|
elif feature.active:
|
|
current = feature.current_provider or "configured provider"
|
|
state = f"active via {current}"
|
|
elif feature.included_by_default and features.nous_auth_present:
|
|
state = "included by subscription, not currently selected"
|
|
elif feature.key == "modal" and features.nous_auth_present:
|
|
state = "available via subscription (optional)"
|
|
else:
|
|
state = "not configured"
|
|
print(f" {feature.label:<15} {check_mark(feature.available or feature.active or feature.managed_by_nous)} {state}")
|
|
elif nous_logged_in:
|
|
# Logged into Nous but on the free tier — show upgrade nudge
|
|
print()
|
|
print(color("◆ Nous Tool Gateway", Colors.CYAN, Colors.BOLD))
|
|
print(" Your free-tier Nous account does not include Tool Gateway access.")
|
|
print(" Upgrade your subscription to unlock managed web, image, TTS, and browser tools.")
|
|
try:
|
|
portal_url = nous_status.get("portal_base_url", "").rstrip("/")
|
|
if portal_url:
|
|
print(f" Upgrade: {portal_url}")
|
|
except Exception:
|
|
pass
|
|
|
|
# =========================================================================
|
|
# API-Key Providers
|
|
# =========================================================================
|
|
print()
|
|
print(color("◆ API-Key Providers", Colors.CYAN, Colors.BOLD))
|
|
|
|
apikey_providers = {
|
|
"Z.AI / GLM": ("GLM_API_KEY", "ZAI_API_KEY", "Z_AI_API_KEY"),
|
|
"Kimi / Moonshot": ("KIMI_API_KEY",),
|
|
"MiniMax": ("MINIMAX_API_KEY",),
|
|
"MiniMax (China)": ("MINIMAX_CN_API_KEY",),
|
|
}
|
|
for pname, env_vars in apikey_providers.items():
|
|
key_val = ""
|
|
for ev in env_vars:
|
|
key_val = get_env_value(ev) or ""
|
|
if key_val:
|
|
break
|
|
configured = bool(key_val)
|
|
label = "configured" if configured else "not configured (run: hermes model)"
|
|
print(f" {pname:<16} {check_mark(configured)} {label}")
|
|
|
|
# =========================================================================
|
|
# Terminal Configuration
|
|
# =========================================================================
|
|
print()
|
|
print(color("◆ Terminal Backend", Colors.CYAN, Colors.BOLD))
|
|
|
|
terminal_env = os.getenv("TERMINAL_ENV", "")
|
|
if not terminal_env:
|
|
# Fall back to config file value when env var isn't set
|
|
# (hermes status doesn't go through cli.py's config loading)
|
|
try:
|
|
_cfg = load_config()
|
|
terminal_env = _cfg.get("terminal", {}).get("backend", "local")
|
|
except Exception:
|
|
terminal_env = "local"
|
|
print(f" Backend: {terminal_env}")
|
|
|
|
if terminal_env == "ssh":
|
|
ssh_host = os.getenv("TERMINAL_SSH_HOST", "")
|
|
ssh_user = os.getenv("TERMINAL_SSH_USER", "")
|
|
print(f" SSH Host: {ssh_host or '(not set)'}")
|
|
print(f" SSH User: {ssh_user or '(not set)'}")
|
|
elif terminal_env == "docker":
|
|
docker_image = os.getenv("TERMINAL_DOCKER_IMAGE", "python:3.11-slim")
|
|
print(f" Docker Image: {docker_image}")
|
|
elif terminal_env == "daytona":
|
|
daytona_image = os.getenv("TERMINAL_DAYTONA_IMAGE", "nikolaik/python-nodejs:python3.11-nodejs20")
|
|
print(f" Daytona Image: {daytona_image}")
|
|
|
|
sudo_password = os.getenv("SUDO_PASSWORD", "")
|
|
print(f" Sudo: {check_mark(bool(sudo_password))} {'enabled' if sudo_password else 'disabled'}")
|
|
|
|
# =========================================================================
|
|
# Messaging Platforms
|
|
# =========================================================================
|
|
print()
|
|
print(color("◆ Messaging Platforms", Colors.CYAN, Colors.BOLD))
|
|
|
|
platforms = {
|
|
"Telegram": ("TELEGRAM_BOT_TOKEN", "TELEGRAM_HOME_CHANNEL"),
|
|
"Discord": ("DISCORD_BOT_TOKEN", "DISCORD_HOME_CHANNEL"),
|
|
"WhatsApp": ("WHATSAPP_ENABLED", None),
|
|
"Signal": ("SIGNAL_HTTP_URL", "SIGNAL_HOME_CHANNEL"),
|
|
"Slack": ("SLACK_BOT_TOKEN", None),
|
|
"Email": ("EMAIL_ADDRESS", "EMAIL_HOME_ADDRESS"),
|
|
"SMS": ("TWILIO_ACCOUNT_SID", "SMS_HOME_CHANNEL"),
|
|
"DingTalk": ("DINGTALK_CLIENT_ID", None),
|
|
"Feishu": ("FEISHU_APP_ID", "FEISHU_HOME_CHANNEL"),
|
|
"WeCom": ("WECOM_BOT_ID", "WECOM_HOME_CHANNEL"),
|
|
"WeCom Callback": ("WECOM_CALLBACK_CORP_ID", None),
|
|
"Weixin": ("WEIXIN_ACCOUNT_ID", "WEIXIN_HOME_CHANNEL"),
|
|
"BlueBubbles": ("BLUEBUBBLES_SERVER_URL", "BLUEBUBBLES_HOME_CHANNEL"),
|
|
"QQBot": ("QQ_APP_ID", "QQBOT_HOME_CHANNEL"),
|
|
}
|
|
|
|
for name, (token_var, home_var) in platforms.items():
|
|
token = os.getenv(token_var, "")
|
|
has_token = bool(token)
|
|
|
|
home_channel = ""
|
|
if home_var:
|
|
home_channel = os.getenv(home_var, "")
|
|
# Back-compat: QQBot home channel was renamed from QQ_HOME_CHANNEL to QQBOT_HOME_CHANNEL
|
|
if not home_channel and home_var == "QQBOT_HOME_CHANNEL":
|
|
home_channel = os.getenv("QQ_HOME_CHANNEL", "")
|
|
|
|
status = "configured" if has_token else "not configured"
|
|
if home_channel:
|
|
status += f" (home: {home_channel})"
|
|
|
|
print(f" {name:<12} {check_mark(has_token)} {status}")
|
|
|
|
# =========================================================================
|
|
# Gateway Status
|
|
# =========================================================================
|
|
print()
|
|
print(color("◆ Gateway Service", Colors.CYAN, Colors.BOLD))
|
|
|
|
if _is_termux():
|
|
try:
|
|
from hermes_cli.gateway import find_gateway_pids
|
|
gateway_pids = find_gateway_pids()
|
|
except Exception:
|
|
gateway_pids = []
|
|
is_running = bool(gateway_pids)
|
|
print(f" Status: {check_mark(is_running)} {'running' if is_running else 'stopped'}")
|
|
print(" Manager: Termux / manual process")
|
|
if gateway_pids:
|
|
rendered = ", ".join(str(pid) for pid in gateway_pids[:3])
|
|
if len(gateway_pids) > 3:
|
|
rendered += ", ..."
|
|
print(f" PID(s): {rendered}")
|
|
else:
|
|
print(" Start with: hermes gateway")
|
|
print(" Note: Android may stop background jobs when Termux is suspended")
|
|
|
|
elif sys.platform.startswith('linux'):
|
|
from hermes_constants import is_container
|
|
if is_container():
|
|
# Docker/Podman: no systemd — check for running gateway processes
|
|
try:
|
|
from hermes_cli.gateway import find_gateway_pids
|
|
gateway_pids = find_gateway_pids()
|
|
is_active = len(gateway_pids) > 0
|
|
except Exception:
|
|
is_active = False
|
|
print(f" Status: {check_mark(is_active)} {'running' if is_active else 'stopped'}")
|
|
print(" Manager: docker (foreground)")
|
|
else:
|
|
try:
|
|
from hermes_cli.gateway import get_service_name
|
|
_gw_svc = get_service_name()
|
|
except Exception:
|
|
_gw_svc = "hermes-gateway"
|
|
try:
|
|
result = subprocess.run(
|
|
["systemctl", "--user", "is-active", _gw_svc],
|
|
capture_output=True,
|
|
text=True,
|
|
timeout=5
|
|
)
|
|
is_active = result.stdout.strip() == "active"
|
|
except (FileNotFoundError, subprocess.TimeoutExpired):
|
|
is_active = False
|
|
print(f" Status: {check_mark(is_active)} {'running' if is_active else 'stopped'}")
|
|
print(" Manager: systemd (user)")
|
|
|
|
elif sys.platform == 'darwin':
|
|
from hermes_cli.gateway import get_launchd_label
|
|
try:
|
|
result = subprocess.run(
|
|
["launchctl", "list", get_launchd_label()],
|
|
capture_output=True,
|
|
text=True,
|
|
timeout=5
|
|
)
|
|
is_loaded = result.returncode == 0
|
|
except subprocess.TimeoutExpired:
|
|
is_loaded = False
|
|
print(f" Status: {check_mark(is_loaded)} {'loaded' if is_loaded else 'not loaded'}")
|
|
print(" Manager: launchd")
|
|
else:
|
|
print(f" Status: {color('N/A', Colors.DIM)}")
|
|
print(" Manager: (not supported on this platform)")
|
|
|
|
# =========================================================================
|
|
# Cron Jobs
|
|
# =========================================================================
|
|
print()
|
|
print(color("◆ Scheduled Jobs", Colors.CYAN, Colors.BOLD))
|
|
|
|
jobs_file = get_hermes_home() / "cron" / "jobs.json"
|
|
if jobs_file.exists():
|
|
import json
|
|
try:
|
|
with open(jobs_file, encoding="utf-8") as f:
|
|
data = json.load(f)
|
|
jobs = data.get("jobs", [])
|
|
enabled_jobs = [j for j in jobs if j.get("enabled", True)]
|
|
print(f" Jobs: {len(enabled_jobs)} active, {len(jobs)} total")
|
|
except Exception:
|
|
print(" Jobs: (error reading jobs file)")
|
|
else:
|
|
print(" Jobs: 0")
|
|
|
|
# =========================================================================
|
|
# Sessions
|
|
# =========================================================================
|
|
print()
|
|
print(color("◆ Sessions", Colors.CYAN, Colors.BOLD))
|
|
|
|
sessions_file = get_hermes_home() / "sessions" / "sessions.json"
|
|
if sessions_file.exists():
|
|
import json
|
|
try:
|
|
with open(sessions_file, encoding="utf-8") as f:
|
|
data = json.load(f)
|
|
print(f" Active: {len(data)} session(s)")
|
|
except Exception:
|
|
print(" Active: (error reading sessions file)")
|
|
else:
|
|
print(" Active: 0")
|
|
|
|
# =========================================================================
|
|
# Deep checks
|
|
# =========================================================================
|
|
if deep:
|
|
print()
|
|
print(color("◆ Deep Checks", Colors.CYAN, Colors.BOLD))
|
|
|
|
# Check OpenRouter connectivity
|
|
openrouter_key = os.getenv("OPENROUTER_API_KEY", "")
|
|
if openrouter_key:
|
|
try:
|
|
import httpx
|
|
response = httpx.get(
|
|
OPENROUTER_MODELS_URL,
|
|
headers={"Authorization": f"Bearer {openrouter_key}"},
|
|
timeout=10
|
|
)
|
|
ok = response.status_code == 200
|
|
print(f" OpenRouter: {check_mark(ok)} {'reachable' if ok else f'error ({response.status_code})'}")
|
|
except Exception as e:
|
|
print(f" OpenRouter: {check_mark(False)} error: {e}")
|
|
|
|
# Check gateway port
|
|
try:
|
|
import socket
|
|
sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
|
|
sock.settimeout(1)
|
|
result = sock.connect_ex(('127.0.0.1', 18789))
|
|
sock.close()
|
|
# Port in use = gateway likely running
|
|
port_in_use = result == 0
|
|
# This is informational, not necessarily bad
|
|
print(f" Port 18789: {'in use' if port_in_use else 'available'}")
|
|
except OSError:
|
|
pass
|
|
|
|
print()
|
|
print(color("─" * 60, Colors.DIM))
|
|
print(color(" Run 'hermes doctor' for detailed diagnostics", Colors.DIM))
|
|
print(color(" Run 'hermes setup' to configure", Colors.DIM))
|
|
print()
|