session_secret_prompt.py 2.5 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152
  1. """The masked skill-secret prompt for a local viewer's turn.
  2. Main's classic CLI registered ``set_secret_capture_callback`` in process: a skill whose
  3. ``required_environment_variables`` are missing opened the masked "Skill Setup Required" panel and the
  4. value was saved to the profile ``.env`` (``save_env_value_secure``) without ever reaching the model.
  5. On the session authority the skill runs in the gateway, where a gateway surface only got the
  6. "secret entry is not available" hint. For a local viewer's turn the owner now sends main's ``secret``
  7. server→client request (``tui_gateway/contracts/server_requests.py``: ``SecretRequestParams`` →
  8. ``ValueResult``) to the attached viewers, saves a non-empty answer in this profile's ``.env`` here,
  9. and returns main's callback result. The value travels only in the viewer's response frame.
  10. """
  11. from __future__ import annotations
  12. import contextlib
  13. import logging
  14. logger = logging.getLogger(__name__)
  15. SECRET_TIMEOUT_S = 120 # main's CLI secret panel deadline (hermes_cli/callbacks.py)
  16. def _skipped(var_name, reason, message):
  17. return {"success": True, "reason": reason, "stored_as": var_name, "validated": False,
  18. "skipped": True, "message": message}
  19. @contextlib.contextmanager
  20. def secret_prompt_scope(turn, agent):
  21. """Bind this turn's secret-capture callback (a ContextVar, so parallel tool workers inherit it)."""
  22. from gateway.run_turn_progress import local_viewer_turn
  23. if not local_viewer_turn(turn):
  24. yield
  25. return
  26. from tools.skills_tool import bind_turn_secret_capture
  27. authority, session_id, _generation = turn._approval_owner
  28. def callback(var_name, prompt, metadata=None):
  29. from gateway.session_server_requests import ask_viewer
  30. live = authority.sessions.get(session_id)
  31. if live is None:
  32. return _skipped(var_name, "cancelled", "Secret setup was skipped.")
  33. params = {"env_var": var_name, "prompt": prompt, **({"metadata": metadata} if metadata else {})}
  34. value = ask_viewer(live.event_stream, session_id, "secret", params, timeout=SECRET_TIMEOUT_S,
  35. cancelled=lambda: bool(getattr(agent, "_interrupt_requested", False)))
  36. if not value:
  37. return _skipped(var_name, "cancelled", "Secret setup was skipped.")
  38. from hermes_cli.config import save_env_value_secure
  39. return {**save_env_value_secure(var_name, value), "skipped": False,
  40. "message": "Secret stored securely. The secret value was not exposed to the model."}
  41. with bind_turn_secret_capture(callback):
  42. yield