tools.py 2.6 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950
  1. """``hermes tools`` subcommand parser."""
  2. from __future__ import annotations
  3. from typing import Callable
  4. def build_tools_parser(subparsers, *, cmd_tools: Callable) -> None:
  5. """Attach the ``tools`` subcommand to ``subparsers``."""
  6. tools_parser = subparsers.add_parser(
  7. "tools", help="Configure which tools are enabled per platform",
  8. description="Enable, disable, or list tools for CLI, Telegram, Discord, etc.\n\n"
  9. "Built-in toolsets use plain names (e.g. web, memory).\n"
  10. "MCP tools use server:tool notation (e.g. github:create_issue).\n\n"
  11. "Run 'hermes tools' with no subcommand for the interactive configuration UI.")
  12. tools_parser.add_argument(
  13. "--summary", action="store_true",
  14. help="Print a summary of enabled tools per platform and exit")
  15. tools_sub = tools_parser.add_subparsers(dest="tools_action")
  16. tools_list_p = tools_sub.add_parser(
  17. "list", help="Show all tools and their enabled/disabled status")
  18. tools_list_p.add_argument("--platform", default="cli", help="Platform to show (default: cli)")
  19. tools_disable_p = tools_sub.add_parser("disable", help="Disable toolsets or MCP tools")
  20. tools_disable_p.add_argument(
  21. "names", nargs="+", metavar="NAME",
  22. help="Toolset name (e.g. web) or MCP tool in server:tool form")
  23. tools_disable_p.add_argument(
  24. "--platform", default="cli", help="Platform to apply to (default: cli)")
  25. tools_enable_p = tools_sub.add_parser("enable", help="Enable toolsets or MCP tools")
  26. tools_enable_p.add_argument(
  27. "names", nargs="+", metavar="NAME", help="Toolset name or MCP tool in server:tool form")
  28. tools_enable_p.add_argument(
  29. "--platform", default="cli", help="Platform to apply to (default: cli)")
  30. tools_postsetup_p = tools_sub.add_parser(
  31. "post-setup", help="Run a provider's post-setup install hook (npm/pip/binary)",
  32. description="Run the install/bootstrap hook a tool backend declares — the\n"
  33. "same step `hermes tools` runs after you pick a provider that\n"
  34. "needs extra dependencies (browser Chromium, Lightpanda, cua-driver,\n"
  35. "KittenTTS/Piper, ddgs, xAI, Codex). Stable,\n"
  36. "non-interactive target the dashboard spawns to drive backend\n"
  37. "setup. Keys: chromium, lightpanda, cua_driver, kittentts,\n"
  38. "piper, ddgs, xai_grok, openai_codex.")
  39. tools_postsetup_p.add_argument(
  40. "post_setup_key", metavar="KEY",
  41. help="Post-setup hook key (e.g. chromium, cua_driver, kittentts)")
  42. tools_parser.set_defaults(func=cmd_tools)