mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-04-25 00:51:20 +00:00
8d023e43ed
Deep scan with vulture, pyflakes, and manual cross-referencing identified: - 41 dead functions/methods (zero callers in production) - 7 production-dead functions (only test callers, tests deleted) - 5 dead constants/variables - ~35 unused imports across agent/, hermes_cli/, tools/, gateway/ Categories of dead code removed: - Refactoring leftovers: _set_default_model, _setup_copilot_reasoning_selection, rebuild_lookups, clear_session_context, get_logs_dir, clear_session - Unused API surface: search_models_dev, get_pricing, skills_categories, get_read_files_summary, clear_read_tracker, menu_labels, get_spinner_list - Dead compatibility wrappers: schedule_cronjob, list_cronjobs, remove_cronjob - Stale debug helpers: get_debug_session_info copies in 4 tool files (centralized version in debug_helpers.py already exists) - Dead gateway methods: send_emote, send_notice (matrix), send_reaction (bluebubbles), _normalize_inbound_text (feishu), fetch_room_history (matrix), _start_typing_indicator (signal), parse_feishu_post_content - Dead constants: NOUS_API_BASE_URL, SKILLS_TOOL_DESCRIPTION, FILE_TOOLS, VALID_ASPECT_RATIOS, MEMORY_DIR - Unused UI code: _interactive_provider_selection, _interactive_model_selection (superseded by prompt_toolkit picker) Test suite verified: 609 tests covering affected files all pass. Tests for removed functions deleted. Tests using removed utilities (clear_read_tracker, MEMORY_DIR) updated to use internal APIs directly.
85 lines
2.6 KiB
Python
85 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 threading
|
|
|
|
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()
|