callbacks.py 3.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100
  1. """Secret-capture prompt for the interactive CLI (``_secret_capture_callback`` backend)."""
  2. import queue
  3. import time as _time
  4. from hermes_cli.banner import cprint, _DIM, _RST
  5. from hermes_cli.config import save_env_value_secure
  6. from hermes_cli.secret_prompt import masked_secret_prompt
  7. from hermes_constants import display_hermes_home
  8. def _invalidate(cli) -> None:
  9. if hasattr(cli, "_paint_now"):
  10. cli._paint_now()
  11. elif getattr(cli, "_app", None):
  12. cli._app.invalidate()
  13. def _clear_secret_input(cli) -> None:
  14. """Drop stale draft input so Enter never stores it as the secret."""
  15. try:
  16. if hasattr(cli, "_clear_secret_input_buffer"):
  17. cli._clear_secret_input_buffer()
  18. elif getattr(cli, "_app", None):
  19. cli._app.current_buffer.reset()
  20. except Exception:
  21. pass
  22. def _skipped(var_name: str, reason: str, message: str) -> dict:
  23. return {
  24. "success": True, "reason": reason, "stored_as": var_name,
  25. "validated": False, "skipped": True, "message": message}
  26. def _secret_result(var_name: str, value: str) -> dict:
  27. """Store ``value`` (or report a skip when empty) and build the callback result dict."""
  28. if not value:
  29. cprint(f"\n{_DIM} ⏭ Secret entry skipped{_RST}")
  30. return _skipped(var_name, "cancelled", "Secret setup was skipped.")
  31. try:
  32. stored = save_env_value_secure(var_name, value)
  33. except ValueError as exc: # a locked or denylisted key: the skill setup only logs it, so say why here
  34. cprint(f"\n ✗ {exc}")
  35. raise
  36. cprint(f"\n{_DIM} ✓ Stored secret in {display_hermes_home()}/.env as {var_name}{_RST}")
  37. return {
  38. **stored,
  39. "skipped": False,
  40. "message": "Secret stored securely. The secret value was not exposed to the model."}
  41. def prompt_for_secret(cli, var_name: str, prompt: str, metadata=None) -> dict:
  42. """Prompt for a secret value through the TUI (e.g. API keys for skills).
  43. Returns a dict with keys: success, stored_as, validated, skipped, message. The secret is stored
  44. in ~/.hermes/.env and never exposed to the model.
  45. """
  46. if not getattr(cli, "_app", None):
  47. if not hasattr(cli, "_secret_state"):
  48. cli._secret_state = None
  49. if not hasattr(cli, "_secret_deadline"):
  50. cli._secret_deadline = 0
  51. try:
  52. value = masked_secret_prompt(f"{prompt} (hidden, ESC or empty Enter to skip): ")
  53. except (EOFError, KeyboardInterrupt):
  54. value = ""
  55. return _secret_result(var_name, value)
  56. response_queue = queue.Queue()
  57. cli._secret_state = {
  58. "var_name": var_name,
  59. "prompt": prompt,
  60. "metadata": metadata or {},
  61. "response_queue": response_queue}
  62. cli._secret_deadline = _time.monotonic() + 120
  63. if hasattr(cli, "_ring_bell"):
  64. cli._ring_bell(prompt=True, context=f"secret needed ({var_name})")
  65. _clear_secret_input(cli)
  66. _invalidate(cli)
  67. while True:
  68. try:
  69. value = response_queue.get(timeout=1)
  70. except queue.Empty:
  71. if cli._secret_deadline - _time.monotonic() <= 0:
  72. break
  73. _invalidate(cli)
  74. continue
  75. cli._secret_state = None
  76. cli._secret_deadline = 0
  77. _invalidate(cli)
  78. return _secret_result(var_name, value)
  79. cli._secret_state = None
  80. cli._secret_deadline = 0
  81. _clear_secret_input(cli)
  82. _invalidate(cli)
  83. cprint(f"\n{_DIM} ⏱ Timeout — secret capture cancelled{_RST}")
  84. return _skipped(var_name, "timeout", "Secret setup timed out and was skipped.")