187e90e425
16 callsites across 14 files were re-deriving the hermes home path
via os.environ.get('HERMES_HOME', ...) instead of using the canonical
get_hermes_home() from hermes_constants. This breaks profiles — each
profile has its own HERMES_HOME, and the inline fallback defaults to
~/.hermes regardless.
Fixed by importing and calling get_hermes_home() at each site. For
files already inside the hermes process (agent/, hermes_cli/, tools/,
gateway/, plugins/), this is always safe. Files that run outside the
process context (mcp_serve.py, mcp_oauth.py) already had correct
try/except ImportError fallbacks and were left alone.
Skipped: hermes_constants.py (IS the implementation), env_loader.py
(bootstrap), profiles.py (intentionally manipulates the env var),
standalone scripts (optional-skills/, skills/), and tests.
88 lines
2.6 KiB
Python
88 lines
2.6 KiB
Python
"""Built-in boot-md hook — run ~/.hermes/BOOT.md on gateway startup.
|
|
|
|
This hook is always registered. It silently skips if no BOOT.md exists.
|
|
To activate, create ``~/.hermes/BOOT.md`` with instructions for the
|
|
agent to execute on every gateway restart.
|
|
|
|
Example BOOT.md::
|
|
|
|
# Startup Checklist
|
|
|
|
1. Check if any cron jobs failed overnight
|
|
2. Send a status update to Discord #general
|
|
3. If there are errors in /opt/app/deploy.log, summarize them
|
|
|
|
The agent runs in a background thread so it doesn't block gateway
|
|
startup. If nothing needs attention, it replies with [SILENT] to
|
|
suppress delivery.
|
|
"""
|
|
|
|
import logging
|
|
import os
|
|
import threading
|
|
from pathlib import Path
|
|
|
|
logger = logging.getLogger("hooks.boot-md")
|
|
|
|
from hermes_constants import get_hermes_home
|
|
HERMES_HOME = get_hermes_home()
|
|
BOOT_FILE = HERMES_HOME / "BOOT.md"
|
|
|
|
|
|
def _build_boot_prompt(content: str) -> str:
|
|
"""Wrap BOOT.md content in a system-level instruction."""
|
|
return (
|
|
"You are running a startup boot checklist. Follow the BOOT.md "
|
|
"instructions below exactly.\n\n"
|
|
"---\n"
|
|
f"{content}\n"
|
|
"---\n\n"
|
|
"Execute each instruction. If you need to send a message to a "
|
|
"platform, use the send_message tool.\n"
|
|
"If nothing needs attention and there is nothing to report, "
|
|
"reply with ONLY: [SILENT]"
|
|
)
|
|
|
|
|
|
def _run_boot_agent(content: str) -> None:
|
|
"""Spawn a one-shot agent session to execute the boot instructions."""
|
|
try:
|
|
from run_agent import AIAgent
|
|
|
|
prompt = _build_boot_prompt(content)
|
|
agent = AIAgent(
|
|
quiet_mode=True,
|
|
skip_context_files=True,
|
|
skip_memory=True,
|
|
max_iterations=20,
|
|
)
|
|
result = agent.run_conversation(prompt)
|
|
response = result.get("final_response", "")
|
|
if response and "[SILENT]" not in response:
|
|
logger.info("boot-md completed: %s", response[:200])
|
|
else:
|
|
logger.info("boot-md completed (nothing to report)")
|
|
except Exception as e:
|
|
logger.error("boot-md agent failed: %s", e)
|
|
|
|
|
|
async def handle(event_type: str, context: dict) -> None:
|
|
"""Gateway startup handler — run BOOT.md if it exists."""
|
|
if not BOOT_FILE.exists():
|
|
return
|
|
|
|
content = BOOT_FILE.read_text(encoding="utf-8").strip()
|
|
if not content:
|
|
return
|
|
|
|
logger.info("Running BOOT.md (%d chars)", len(content))
|
|
|
|
# Run in a background thread so we don't block gateway startup.
|
|
thread = threading.Thread(
|
|
target=_run_boot_agent,
|
|
args=(content,),
|
|
name="boot-md",
|
|
daemon=True,
|
|
)
|
|
thread.start()
|