| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384 |
- """Shared wording for the exec-approval prompt every messaging surface renders.
- The button card (``BasePlatformAdapter._format_exec_approval``) and the plain-text
- ``/approve`` fallback (``gateway.run._format_exec_approval_fallback``) must tell the user
- the same three things: what Hermes wants to run, why it was flagged, and that silence means
- the command does NOT run once ``approvals.timeout`` elapses. Keeping the text here means one
- edit changes every platform; adapters only wrap these strings in their own markup.
- The ``EA_*`` / ``APPROVAL_TIMED_OUT_NOTICE`` module constants are the English source of truth
- (catalog keys ``gateway.exec_approval.*``); anything that renders the prompt calls the sibling
- accessors (``ea_header_text()`` …) so the active ``display.language`` is honoured at render time.
- No imports from ``gateway.platforms.base`` or ``gateway.run`` — both import this module.
- """
- from __future__ import annotations
- from agent.i18n import t
- # Bare strings; adapters add their own bold/HTML around them.
- EA_HEADER_TEXT = "Hermes wants to run a command that needs your OK"
- EA_REASON_LABEL_TEXT = "Why it was flagged"
- # Timeout notice posted when nobody answered the prompt (``{window}`` = "5 minutes").
- APPROVAL_TIMED_OUT_NOTICE = (
- "⌛ Approval timed out after {window} — the command was NOT run. "
- "Ask me to try again if you still want it, or raise approvals.timeout in config.yaml.")
- def ea_header_text() -> str:
- """Localized ``EA_HEADER_TEXT``."""
- return t("gateway.exec_approval.header")
- def ea_reason_label_text() -> str:
- """Localized ``EA_REASON_LABEL_TEXT``."""
- return t("gateway.exec_approval.reason_label")
- def ea_smart_deny_line_text() -> str:
- """Localized smart-deny sentence (bare; adapters add their own line breaks/markup)."""
- return t("gateway.exec_approval.smart_deny_line")
- def ea_default_reason_text() -> str:
- """Localized default "why it was flagged" reason when the approval carries none."""
- return t("gateway.exec_approval.default_reason")
- def ea_action_labels() -> dict[str, str]:
- """Localized ``choice -> button label`` for the four approval tiers."""
- return {
- "once": t("gateway.exec_approval.action_once"),
- "session": t("gateway.exec_approval.action_session"),
- "always": t("gateway.exec_approval.action_always"),
- "deny": t("gateway.exec_approval.action_deny"),
- }
- def approval_timed_out_notice(window: str) -> str:
- """Localized ``APPROVAL_TIMED_OUT_NOTICE`` for an already-formatted ``window``."""
- return t("gateway.exec_approval.timed_out_notice", window=window)
- def approval_timeout_seconds() -> int:
- """The configured ``approvals.timeout`` (default 300s); module attribute so tests can pin it."""
- from tools.approval_context import _get_approval_timeout
- return _get_approval_timeout()
- def format_approval_window(seconds: int) -> str:
- """Human wording for a timeout (300 → "5 minutes"); one formatter shared with the CLI notice and
- the tool result's ``user_summary`` — see ``tools.approval_context.format_approval_window``."""
- from tools.approval_context import format_approval_window as _shared
- return _shared(seconds)
- def format_approval_deadline_line(timeout_s: int) -> str:
- """The last line of every approval prompt: doing nothing is a safe no."""
- return t("gateway.exec_approval.deadline", window=format_approval_window(timeout_s))
- def format_approval_timed_out_notice(timeout_s: int) -> str:
- return approval_timed_out_notice(format_approval_window(timeout_s))
|