| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270 |
- """Agent-facing subcommand handlers: memory, acp, tools, insights, monitoring, skills (+trust).
- Split out of ``hermes_cli/main.py``. Names that still live in main (``PROJECT_ROOT``, ...)
- are imported lazily inside the functions that use them (avoids an import cycle).
- """
- from pm import install_hint
- import sys
- def _cmd_memory_off():
- from hermes_cli.config import load_config, save_config
- config = load_config()
- if not isinstance(config.get("memory"), dict):
- config["memory"] = {}
- config["memory"]["provider"] = ""
- save_config(config)
- print("\n ✓ Memory provider: built-in only")
- print(" Saved to config.yaml\n")
- def _cmd_memory_reset(args):
- from hermes_constants import get_hermes_home, display_hermes_home
- mem_dir = get_hermes_home() / "memories"
- target = getattr(args, "target", "all")
- files_to_reset = []
- if target in {"all", "memory"}:
- files_to_reset.append(("MEMORY.md", "agent notes"))
- if target in {"all", "user"}:
- files_to_reset.append(("USER.md", "user profile"))
- existing = [(f, desc) for f, desc in files_to_reset if (mem_dir / f).exists()]
- if not existing:
- print(f"\n Nothing to reset — no memory files found in {display_hermes_home()}/memories/\n")
- return
- print("\n This will permanently erase the following memory files:")
- for f, desc in existing:
- size = (mem_dir / f).stat().st_size
- print(f" ◆ {f} ({desc}) — {size:,} bytes")
- if not getattr(args, "yes", False):
- try:
- answer = input("\n Type 'yes' to confirm: ").strip().lower()
- except (EOFError, KeyboardInterrupt):
- print("\n Cancelled.\n")
- return
- if answer != "yes":
- print(" Cancelled.\n")
- return
- for f, desc in existing:
- (mem_dir / f).unlink()
- print(f" ✓ Deleted {f} ({desc})")
- print("\n Memory reset complete. New sessions will start with a blank slate.")
- print(f" Files were in: {display_hermes_home()}/memories/\n")
- def cmd_memory(args):
- sub = getattr(args, "memory_command", None)
- if sub == "off":
- _cmd_memory_off()
- elif sub == "reset":
- _cmd_memory_reset(args)
- else:
- from hermes_cli.memory_setup import memory_command
- memory_command(args)
- # (args attribute, acp flag) — forwarded in this order.
- _ACP_FLAGS = (
- ("acp_version", "--version"),
- ("check", "--check"),
- ("setup", "--setup"),
- ("setup_browser", "--setup-browser"),
- ("assume_yes", "--yes"))
- def cmd_acp(args):
- """Launch Hermes Agent as an ACP server."""
- import os
- # The gateway-backed ACP server forwards launch flags from their documented env equivalents
- # (main() already exported --yolo / --safe-mode / --ignore-user-config).
- for attr, name in (("accept_hooks", "HERMES_ACCEPT_HOOKS"), ("ignore_rules", "HERMES_IGNORE_RULES")):
- if getattr(args, attr, False):
- os.environ[name] = "1"
- # -m / --provider: the route a --safe-mode / --ignore-user-config session freezes (it reads no
- # profile default), carried like the TUI launcher's.
- for attr, name in (("model", "HERMES_MODEL"), ("provider", "HERMES_INFERENCE_PROVIDER")):
- if getattr(args, attr, None):
- os.environ[name] = getattr(args, attr)
- try:
- from acp_adapter.entry import main as acp_main
- acp_main([flag for attr, flag in _ACP_FLAGS if getattr(args, attr, False)])
- except ImportError as e:
- print("The ACP server can't start: its protocol packages are missing from this install.", file=sys.stderr)
- print("From the Hermes environment, run: "
- f"{install_hint('acp')}", file=sys.stderr)
- print("Then restart Hermes.", file=sys.stderr)
- print(f"Details: {e}", file=sys.stderr)
- sys.exit(1)
- def cmd_tools(args):
- from hermes_cli.main import _require_tty
- action = getattr(args, "tools_action", None)
- if action in {"list", "disable", "enable"}:
- from hermes_cli.tools_config import tools_disable_enable_command
- tools_disable_enable_command(args)
- elif action == "post-setup":
- from hermes_cli.tools_config import run_post_setup_command
- sys.exit(run_post_setup_command(args))
- else:
- _require_tty("tools")
- from hermes_cli.tools_config import tools_command
- tools_command(args)
- def cmd_insights(args):
- db = None
- try:
- from hermes_state import SessionDB
- from agent.insights import InsightsEngine
- from hermes_cli.config import get_hermes_home
- path = get_hermes_home() / "state.db"
- if not path.exists():
- from agent.i18n import t
- print(f" {t('cli.insights.no_session_data')}")
- return
- db = SessionDB(db_path=path, read_only=True)
- engine = InsightsEngine(db)
- report = engine.generate(days=args.days, source=args.source)
- print(engine.format_terminal(report))
- except Exception as e:
- # Interactive /insights delegates here, so keep main's localized error line.
- from agent.i18n import t
- print(t("gateway.insights.error", error=str(e)))
- finally:
- if db is not None:
- try:
- db.close()
- except Exception:
- pass
- def _dict_or_empty(value) -> dict:
- return value if isinstance(value, dict) else {}
- def cmd_monitoring(args):
- """Gateway monitoring status: health & diagnostics export posture."""
- from hermes_cli.config import load_config
- action = getattr(args, "monitoring_action", None) or "status"
- mon = _dict_or_empty(load_config().get("monitoring"))
- if action == "status":
- from agent.monitoring import otlp_exporter
- gh = _dict_or_empty(mon.get("gateway_health_export"))
- otlp = _dict_or_empty(_dict_or_empty(mon.get("export")).get("otlp"))
- print("Gateway monitoring")
- print(f" Health export: {'enabled' if gh.get('enabled') else 'disabled'} "
- f"(monitoring.gateway_health_export.enabled)")
- if gh.get("enabled"):
- print(f" Metrics: {'on' if gh.get('metrics_enabled', True) else 'off'} "
- f"(interval {gh.get('export_interval_seconds', 60)}s)")
- print(f" Diagnostic events: {'on' if gh.get('diagnostic_events_enabled', True) else 'off'}")
- print(f" Warning/error logs: {'on' if gh.get('warning_error_events_enabled', True) else 'off'} "
- f"(interval {gh.get('logs_export_interval_seconds', 5)}s)")
- print(" Content safety: always on "
- "(rendered messages are never exported; not configurable)")
- endpoint = otlp.get("endpoint") or ""
- if otlp.get("enabled") and endpoint:
- print(f" OTLP endpoint: {endpoint}")
- else:
- print(" OTLP endpoint: not configured (monitoring.export.otlp)")
- print(f" OTel SDK: {'installed' if otlp_exporter.is_available() else 'not installed'} "
- f"(optional extra: hermes-agent[otlp])")
- print("\n Scope: gateway service health + redacted diagnostics only.")
- print(" No prompts, messages, tool args/results, usage analytics, or traces.")
- return
- print(f"Unknown monitoring action: {action}", file=sys.stderr)
- sys.exit(2)
- def cmd_skills(args):
- from hermes_cli.main import _require_tty
- action = getattr(args, "skills_action", None)
- if action == "config":
- _require_tty("skills config")
- from hermes_cli.skills_config import skills_command as skills_config_command
- skills_config_command(args)
- elif action in ("trust", "untrust"):
- _cmd_skills_trust(args)
- else:
- from hermes_cli.skills_hub import skills_command
- return skills_command(args)
- def _cmd_skills_trust(args):
- """``hermes skills trust|untrust [path]`` — manage ``skills.trusted_project_dirs``.
- With no path, operates on the project root enclosing the current directory
- (nearest ancestor with ``.git``).
- """
- from pathlib import Path
- from agent.skill_utils import (
- PROJECT_SKILLS_SUBDIRS,
- _candidate_project_skills_dirs,
- find_project_root,
- iter_skill_index_files)
- from hermes_cli.config import load_config, save_config
- action = args.skills_action
- raw_path = getattr(args, "path", None)
- if raw_path:
- root = Path(raw_path).expanduser().resolve()
- if not root.is_dir():
- print(f"Not a directory: {root}")
- return
- else:
- root = find_project_root()
- if root is None:
- print(
- "Not inside a git checkout. Run from a project directory or "
- "pass the project root path explicitly.")
- return
- config = load_config()
- skills_cfg = config.setdefault("skills", {})
- trusted = skills_cfg.get("trusted_project_dirs") or []
- if not isinstance(trusted, list):
- trusted = [trusted]
- trusted = [str(t) for t in trusted]
- root_str = str(root)
- def _same(t: str) -> bool:
- return str(Path(t).expanduser().resolve()) == root_str
- if action == "untrust":
- kept = [t for t in trusted if not _same(t)]
- if len(kept) == len(trusted):
- print(f"{root} was not trusted.")
- return
- skills_cfg["trusted_project_dirs"] = kept
- save_config(config)
- print(f"Untrusted: {root}")
- print("Project skills from this repo will no longer load.")
- return
- if any(_same(t) for t in trusted):
- print(f"Already trusted: {root}")
- else:
- trusted.append(root_str)
- skills_cfg["trusted_project_dirs"] = trusted
- save_config(config)
- print(f"Trusted: {root}")
- # Show what this unlocks
- count = sum(
- sum(1 for _ in iter_skill_index_files(d, "SKILL.md"))
- for d in _candidate_project_skills_dirs(root))
- if count:
- print(
- f"{count} project skill(s) will load in sessions started inside "
- "this repo (they take precedence over same-named profile skills).")
- else:
- subdirs = " or ".join(PROJECT_SKILLS_SUBDIRS)
- print(f"No project skills found yet — add them under {subdirs}.")
|