legacy_cli.py 4.6 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394
  1. """Argument layer for the legacy ``hermes-agent`` runner (``run_agent.main``).
  2. A console script calls its target with no arguments, so pointing ``hermes-agent``
  3. at ``run_agent.main`` ignored argv entirely: ``--help``, ``--version`` and a bare
  4. invocation all ran a real model turn with ``main()``'s built-in demo query, and
  5. ``--query`` was silently dropped (#54648). ``python run_agent.py`` routes through
  6. here too, so the installer's PATH launcher behaves the same way.
  7. """
  8. from __future__ import annotations
  9. # hermes_bootstrap first (UTF-8 stdio on Windows; no-op on POSIX), like every other entry point.
  10. try:
  11. import hermes_bootstrap
  12. except ModuleNotFoundError:
  13. pass # partial `hermes update` — only skips the Windows UTF-8 stdio setup
  14. # The `hermes-agent` console script lands here without hermes_cli.main: repair a `hermes update` killed
  15. # while git wrote the new tree before importing anything else from the checkout.
  16. from hermes_cli import _early_recovery
  17. if _early_recovery.restore_interrupted_pull():
  18. _early_recovery.relaunch_after_restore()
  19. import argparse
  20. from typing import Callable, List, Optional
  21. def _build_parser() -> argparse.ArgumentParser:
  22. from hermes_cli import __release_date__, __version__
  23. parser = argparse.ArgumentParser(
  24. prog="hermes-agent",
  25. description="Legacy single-query Hermes Agent runner. For the full CLI use `hermes`.",
  26. )
  27. parser.add_argument("--version", action="version", version=f"Hermes Agent v{__version__} ({__release_date__})")
  28. parser.add_argument("prompt", nargs="*", help="query to run (same as --query)")
  29. parser.add_argument("--query", "-q", help="natural-language query to run")
  30. parser.add_argument("--model", default="", help="model id (provider/model)")
  31. parser.add_argument("--api-key", "--api_key", dest="api_key", help="API key for the model endpoint")
  32. parser.add_argument("--base-url", "--base_url", dest="base_url", default="", help="model API base URL")
  33. parser.add_argument("--max-turns", "--max_turns", dest="max_turns", type=int, default=10,
  34. help="maximum API call iterations (default: 10)")
  35. parser.add_argument("--enabled-toolsets", "--enabled_toolsets", dest="enabled_toolsets",
  36. help="comma-separated toolsets to enable")
  37. parser.add_argument("--disabled-toolsets", "--disabled_toolsets", dest="disabled_toolsets",
  38. help="comma-separated toolsets to disable")
  39. parser.add_argument("--list-tools", "--list_tools", dest="list_tools", action="store_true",
  40. help="list available tools and exit")
  41. parser.add_argument("--save-trajectories", "--save_trajectories", dest="save_trajectories",
  42. action="store_true", help="append the conversation to trajectory JSONL files")
  43. parser.add_argument("--save-sample", "--save_sample", dest="save_sample", action="store_true",
  44. help="save one trajectory sample to a UUID-named file")
  45. parser.add_argument("--verbose", action="store_true", help="verbose logging")
  46. parser.add_argument("--log-prefix-chars", "--log_prefix_chars", dest="log_prefix_chars", type=int,
  47. default=20, help="characters shown in tool-call log previews (default: 20)")
  48. return parser
  49. def main(argv: Optional[list[str]] = None, *, run: Optional[Callable[..., object]] = None) -> int:
  50. """Parse ``argv`` (default ``sys.argv[1:]``) and run one query through ``run_agent.main``.
  51. Metadata flags and a bare invocation never reach the runner; ``run`` lets
  52. ``python run_agent.py`` pass its own ``main`` instead of importing the module twice.
  53. """
  54. parser = _build_parser()
  55. args = parser.parse_args(argv)
  56. positional = " ".join(args.prompt).strip()
  57. if args.query and positional:
  58. parser.error("pass the query either positionally or via --query, not both")
  59. query = args.query or positional or None
  60. if query is None and not args.list_tools:
  61. parser.print_help()
  62. print("\nNo query given: pass one with --query (or run `hermes` for the interactive CLI).")
  63. return 0
  64. if run is None:
  65. from run_agent import main as run
  66. run(
  67. query=query,
  68. model=args.model,
  69. api_key=args.api_key,
  70. base_url=args.base_url,
  71. max_turns=args.max_turns,
  72. enabled_toolsets=args.enabled_toolsets,
  73. disabled_toolsets=args.disabled_toolsets,
  74. list_tools=args.list_tools,
  75. save_trajectories=args.save_trajectories,
  76. save_sample=args.save_sample,
  77. verbose=args.verbose,
  78. log_prefix_chars=args.log_prefix_chars,
  79. )
  80. return 0